from dataclasses import dataclass from pathlib import Path import os import socket def read_value(name: str, default: str | None = None) -> str: file_name = os.getenv(f"{name}_FILE") if file_name: return Path(file_name).read_text(encoding="utf-8").strip() value = os.getenv(name, default) if value is None: raise RuntimeError(f"{name} is required.") return value def read_positive_int(name: str, default: str) -> int: value = int(os.getenv(name, default)) if value < 1: raise RuntimeError(f"{name} must be positive.") return value def read_positive_float(name: str, default: str) -> float: value = float(os.getenv(name, default)) if value <= 0: raise RuntimeError(f"{name} must be positive.") return value @dataclass(frozen=True) class Settings: app_host: str app_port: int database_url: str session_ttl_seconds: int # PostgreSQL connection pool and timeouts. db_pool_size: int db_max_overflow: int db_pool_timeout_seconds: float db_connect_timeout_seconds: float db_statement_timeout_ms: int # Valkey is a session cache; PostgreSQL stays the source of truth. cache_url: str | None session_cache_ttl_seconds: int cache_timeout_seconds: float cache_max_connections: int cache_retry_after_seconds: float # Lab3: X-Instance-Id is the container hostname (short Docker ID), stable # for the process lifetime; scripts/stop-one.sh maps it to a container. instance_id: str idempotency_ttl_seconds: int # Graceful shutdown: readiness answers 503 for shutdown_drain_seconds so # the LB drops this replica, then uvicorn closes the listener and waits # for in-flight requests up to shutdown_timeout_seconds. shutdown_drain_seconds: float shutdown_timeout_seconds: int def load_settings() -> Settings: session_store = os.getenv("SESSION_STORE", "postgres").lower() if session_store not in {"postgres", "valkey", "redis"}: raise RuntimeError("SESSION_STORE must be postgres, valkey or redis.") cache_url = None if session_store != "postgres": cache_url = read_value("CACHE_URL") return Settings( app_host=os.getenv("APP_HOST", "0.0.0.0"), app_port=int(os.getenv("APP_PORT", "8080")), database_url=read_value("DATABASE_URL"), session_ttl_seconds=read_positive_int("SESSION_TTL_SECONDS", "3600"), db_pool_size=read_positive_int("DB_POOL_SIZE", "10"), db_max_overflow=int(os.getenv("DB_MAX_OVERFLOW", "5")), db_pool_timeout_seconds=read_positive_float("DB_POOL_TIMEOUT_SECONDS", "3"), db_connect_timeout_seconds=read_positive_float( "DB_CONNECT_TIMEOUT_SECONDS", "3" ), db_statement_timeout_ms=read_positive_int("DB_STATEMENT_TIMEOUT_MS", "5000"), cache_url=cache_url, session_cache_ttl_seconds=read_positive_int( "SESSION_CACHE_TTL_SECONDS", "60" ), cache_timeout_seconds=read_positive_float("CACHE_TIMEOUT_SECONDS", "0.25"), cache_max_connections=read_positive_int("CACHE_MAX_CONNECTIONS", "20"), cache_retry_after_seconds=read_positive_float( "CACHE_RETRY_AFTER_SECONDS", "5" ), instance_id=os.getenv("INSTANCE_ID") or socket.gethostname(), idempotency_ttl_seconds=read_positive_int( "IDEMPOTENCY_TTL_SECONDS", "86400" ), shutdown_drain_seconds=read_positive_float( "SHUTDOWN_DRAIN_SECONDS", "3" ), shutdown_timeout_seconds=read_positive_int( "SHUTDOWN_TIMEOUT_SECONDS", "8" ), ) settings = load_settings()