from dataclasses import dataclass import os from pathlib import Path ROOT = Path(__file__).resolve().parents[1] _CONFIGURATION_KEYS = { "APP_HOST", "APP_PORT", "APP_ENV", "DATABASE_URL", "DATABASE_URL_FILE", "CACHE_URL", "CACHE_URL_FILE", "CACHE_TTL_SECONDS", "CACHE_STAMPEDE_PROTECTION", "SESSION_TTL_SECONDS", } @dataclass(frozen=True, slots=True) class Settings: """Проверенная конфигурация запуска HTTP-сервера.""" host: str port: int environment: str database_url: str session_ttl_seconds: int cache_url: str | None cache_ttl_seconds: int cache_stampede_protection: bool def load_settings(env_file: Path = ROOT / ".env") -> Settings: """Читает разрешённые ключи .env, не заменяя явно переданное окружение.""" if env_file.is_file(): for raw_line in env_file.read_text(encoding="utf-8").splitlines(): line = raw_line.strip() if not line or line.startswith("#"): continue key, separator, value = line.partition("=") if not separator or key not in _CONFIGURATION_KEYS: continue value = value.strip() if len(value) >= 2 and value[0] == value[-1] and value[0] in {"'", '"'}: value = value[1:-1] os.environ.setdefault(key, value) def value(name: str, default: str = "") -> str: return os.environ.get(name, default).strip() def number(name: str, default: int) -> int: try: result = int(value(name, str(default))) except ValueError as error: raise ValueError(f"{name} должен быть целым числом") from error if result < 1: raise ValueError(f"{name} должен быть положительным") return result def url(name: str, file_name: str, prefixes: tuple[str, ...]) -> str: result = value(name) path = value(file_name) if path: try: result = Path(path).read_text(encoding="utf-8").strip() except OSError as error: raise ValueError(f"{file_name} недоступен") from error if result and not result.startswith(prefixes): raise ValueError(f"{name} содержит неверный URL") return result host = value("APP_HOST", "0.0.0.0") environment = value("APP_ENV", "lab") if not host: raise ValueError("APP_HOST не может быть пустым") if not environment: raise ValueError("APP_ENV не может быть пустым") port = number("APP_PORT", 8080) if port > 65535: raise ValueError("APP_PORT должен находиться в диапазоне 1..65535") database_url = url( "DATABASE_URL", "DATABASE_URL_FILE", ("postgresql://", "postgres://") ) if not database_url: raise ValueError("Нужен PostgreSQL DATABASE_URL или DATABASE_URL_FILE") cache_url = url("CACHE_URL", "CACHE_URL_FILE", ("redis://", "rediss://")) raw_protection = value("CACHE_STAMPEDE_PROTECTION", "true").lower() if raw_protection not in {"true", "false"}: raise ValueError("CACHE_STAMPEDE_PROTECTION должен быть true или false") return Settings( host=host, port=port, environment=environment, database_url=database_url, session_ttl_seconds=number("SESSION_TTL_SECONDS", 3600), cache_url=cache_url or None, cache_ttl_seconds=number("CACHE_TTL_SECONDS", 60), cache_stampede_protection=raw_protection == "true", )