Function is_debug

shared_lib/logger.py:8–37

Single source of truth for the DEBUG flag. Checked here, the lowest-level module, so every other module can share one definition (env var first, then env_file) without circular imports. Accepts True/TRUE and optionally-quoted values so a stray capital doesn't half-enable debug acros

()

def is_debug() -> bool:
    """Single source of truth for the DEBUG flag.

    Checked here, the lowest-level module, so every other module can share one
    definition (env var first, then env_file) without circular imports. Accepts
    True/TRUE and optionally-quoted values so a stray capital doesn't half-enable
    debug across the stack.
    """
    # 1. Check environment
    if os.environ.get("DEBUG", "").lower() == "true":
        return True

    # 2. Check env_file manually
    if os.path.exists(str(ENV_FILE)):
        try:
            with open(str(ENV_FILE), "r", encoding="utf-8") as f:
                for line in f:
                    # Robust check for DEBUG=true (handles spaces, optional quotes, etc.)
                    line = line.strip()
                    if not line or line.startswith("#"):
                        continue
                    if "DEBUG" in line and "=" in line:
                        key, val = [p.strip() for p in line.split("=", 1)]
                        if key == "DEBUG":
                            return val.strip("'\"").lower() == "true"
        except Exception:
            # If the env file cannot be read for any reason, fail closed and
            # leave DEBUG disabled by returning False below.
            pass
    return False


# Setup handlers