zappa_settings_callback.py

import os

REMOTE_DRIVERS = ("sqlite-remote", "mysql")


def check_integrity(zappa_cli):
    command = zappa_cli.command
    if command not in ("deploy", "update"):
        return

    env = zappa_cli.aws_environment_variables or {}

    db_provider = env.get("TC_DRIVER_PROVIDER")
    if db_provider not in REMOTE_DRIVERS:
        raise ValueError(
            f"TC_DRIVER_PROVIDER environment variable must be one of {REMOTE_DRIVERS}"
        )

    db_path = env.get("TC_DRIVER_PATH")
    if not db_path:
        raise ValueError("TC_DRIVER_PATH environment variable must be set")

    try:
        from terracotta import get_driver, exceptions
    except ImportError as exc:
        raise RuntimeError(
            "Terracotta must be installed before deployment (e.g. via `pip install .`)"
        ) from exc

    os.environ.update(env)
    driver = get_driver(db_path, provider=db_provider)

    # this checks if DB is reachable, readable, and whether its version matches
    try:
        with driver.connect():
            some_dataset = next(iter(driver.get_datasets().keys()))
    except exceptions.InvalidDatabaseError as exc:
        raise RuntimeError(
            "Error while connecting to remote database. Please double-check your AWS environment "
            "variables, and make sure your machine has access to the remote Terracotta database."
        ) from exc

    # this makes sure that a random raster file is readable
    with driver.connect():
        driver.get_raster_tile(some_dataset)