78 lines
2.5 KiB
Python
78 lines
2.5 KiB
Python
"""Local development configuration for the HLL Vietnam backend bootstrap."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
from pathlib import Path
|
|
|
|
|
|
DEFAULT_HOST = "127.0.0.1"
|
|
DEFAULT_PORT = 8000
|
|
DEFAULT_STORAGE_FILENAME = "hll_vietnam_dev.sqlite3"
|
|
DEFAULT_REFRESH_INTERVAL_SECONDS = 60
|
|
DEFAULT_ALLOWED_ORIGINS = (
|
|
"null",
|
|
"http://127.0.0.1:5500",
|
|
"http://127.0.0.1:8080",
|
|
"http://localhost:5500",
|
|
"http://localhost:8080",
|
|
)
|
|
DEFAULT_A2S_TARGETS_ENV_VAR = "HLL_BACKEND_A2S_TARGETS"
|
|
DEFAULT_A2S_SOURCE_NAME = "community-hispana-a2s"
|
|
|
|
|
|
def get_bind_address() -> tuple[str, int]:
|
|
"""Return the host and port used by the local backend bootstrap."""
|
|
host = os.getenv("HLL_BACKEND_HOST", DEFAULT_HOST)
|
|
port = int(os.getenv("HLL_BACKEND_PORT", str(DEFAULT_PORT)))
|
|
return host, port
|
|
|
|
|
|
def get_allowed_origins() -> tuple[str, ...]:
|
|
"""Return the small allowlist used for local frontend development."""
|
|
raw_origins = os.getenv(
|
|
"HLL_BACKEND_ALLOWED_ORIGINS",
|
|
",".join(DEFAULT_ALLOWED_ORIGINS),
|
|
)
|
|
origins = []
|
|
for origin in raw_origins.split(","):
|
|
normalized_origin = _normalize_origin(origin)
|
|
if normalized_origin:
|
|
origins.append(normalized_origin)
|
|
return tuple(origins) or DEFAULT_ALLOWED_ORIGINS
|
|
|
|
|
|
def _normalize_origin(origin: str) -> str:
|
|
"""Normalize configured origins so env overrides match browser Origin values."""
|
|
return origin.strip().rstrip("/")
|
|
|
|
|
|
def get_storage_path() -> Path:
|
|
"""Return the local SQLite path used for development snapshot persistence."""
|
|
default_path = Path(__file__).resolve().parent.parent / "data" / DEFAULT_STORAGE_FILENAME
|
|
configured_path = os.getenv("HLL_BACKEND_STORAGE_PATH")
|
|
return Path(configured_path) if configured_path else default_path
|
|
|
|
|
|
def get_refresh_interval_seconds() -> int:
|
|
"""Return the default interval used by the local refresh loop."""
|
|
configured_value = os.getenv(
|
|
"HLL_BACKEND_REFRESH_INTERVAL_SECONDS",
|
|
str(DEFAULT_REFRESH_INTERVAL_SECONDS),
|
|
)
|
|
interval_seconds = int(configured_value)
|
|
if interval_seconds <= 0:
|
|
raise ValueError("HLL_BACKEND_REFRESH_INTERVAL_SECONDS must be positive.")
|
|
|
|
return interval_seconds
|
|
|
|
|
|
def get_a2s_targets_payload() -> str | None:
|
|
"""Return the optional JSON payload that overrides local A2S targets."""
|
|
raw_payload = os.getenv(DEFAULT_A2S_TARGETS_ENV_VAR)
|
|
if raw_payload is None:
|
|
return None
|
|
|
|
normalized = raw_payload.strip()
|
|
return normalized or None
|