Skip to content

bootstrap

azure_bootstrap.bootstrap

v1-compatible wrappers and helpers.

ensure_bootstrap() is the lazy idempotent entry-point most apps want; load_local_settings() mirrors the Azure Functions local.settings.json convention for ergonomic dev setups.

Functions:

Name Description
bootstrap_initialized

Process-local state probe — useful for /api/health/ready endpoints.
ensure_bootstrap

Lazy idempotent wrapper around v1 initialize_application.
load_local_settings

Load env vars from an Azure-Functions-style local.settings.json.

bootstrap_initialized 

bootstrap_initialized() -> bool

Process-local state probe — useful for /api/health/ready endpoints.

Source code in azure_bootstrap/bootstrap/__init__.py 
26
27
28
def bootstrap_initialized() -> bool:
    """Process-local state probe — useful for /api/health/ready endpoints."""
    return _bootstrap_initialized

ensure_bootstrap 

ensure_bootstrap() -> None

Lazy idempotent wrapper around v1 initialize_application.

Short-circuits when USE_MOCK_BOOTSTRAP is truthy (sets the initialized flag and returns without contacting Azure). On real bootstrap, calls v1 initialize_application() and sets the flag. Re-raises on failure after logging at ERROR with traceback.

Source code in azure_bootstrap/bootstrap/__init__.py 
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
def ensure_bootstrap() -> None:
    """Lazy idempotent wrapper around v1 ``initialize_application``.

    Short-circuits when ``USE_MOCK_BOOTSTRAP`` is truthy (sets the
    initialized flag and returns without contacting Azure). On real
    bootstrap, calls v1 ``initialize_application()`` and sets the flag.
    Re-raises on failure after logging at ERROR with traceback.
    """
    global _bootstrap_initialized
    if _bootstrap_initialized:
        return
    logger = get_bootstrap_logger(__name__)
    if _mock_bootstrap_enabled():
        logger.info("Bootstrap mock mode active; skipping Azure connections")
        _bootstrap_initialized = True
        return
    try:
        from azure_bootstrap.services.application_bootstrap import initialize_application

        initialize_application()
        _bootstrap_initialized = True
    except Exception:
        logger.error("Bootstrap initialization failed", exc_info=True)
        raise

load_local_settings 

load_local_settings(path: str | Path = 'local.settings.json') -> int

Load env vars from an Azure-Functions-style local.settings.json.

Behavior: - Missing file: silent, returns 0. - Keys starting with _ are documentation sentinels; skipped. - Never overrides an existing os.environ entry. - JSON / OS errors are logged at WARNING and return 0.

Source code in azure_bootstrap/bootstrap/__init__.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
def load_local_settings(path: str | Path = "local.settings.json") -> int:
    """Load env vars from an Azure-Functions-style ``local.settings.json``.

    Behavior:
    - Missing file: silent, returns 0.
    - Keys starting with ``_`` are documentation sentinels; skipped.
    - Never overrides an existing ``os.environ`` entry.
    - JSON / OS errors are logged at WARNING and return 0.
    """
    p = Path(path)
    if not p.exists():
        return 0
    logger = logging.getLogger(__name__)
    try:
        raw = p.read_text(encoding="utf-8")
        data = json.loads(raw)
    except (OSError, json.JSONDecodeError) as exc:
        logger.warning("Failed to load local settings from %s: %s", path, exc)
        return 0
    values = data.get("Values") if isinstance(data, dict) else None
    if not isinstance(values, dict):
        return 0
    loaded = 0
    for key, value in values.items():
        if not isinstance(key, str) or key.startswith("_"):
            continue
        if key in os.environ:
            continue
        try:
            os.environ[key] = str(value)
            loaded += 1
        except Exception:
            continue
    return loaded