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", "SESSION_TTL_SECONDS", "IDEMPOTENCY_TTL_SECONDS", "INSTANCE_ID", "CURSOR_SECRET", "CURSOR_SECRET_FILE", "S3_ENDPOINT", "S3_REGION", "S3_BUCKET", "S3_ACCESS_KEY_ID", "S3_ACCESS_KEY_ID_FILE", "S3_SECRET_ACCESS_KEY", "S3_SECRET_ACCESS_KEY_FILE", "MAX_UPLOAD_BYTES", "MAX_IMAGE_PIXELS", "UPLOAD_CONCURRENCY", "UPLOAD_TIMEOUT_SECONDS", "UPLOAD_FAULT_AFTER_S3_PUT", } @dataclass(frozen=True, slots=True) class Settings: """Проверенная конфигурация запуска HTTP-сервера.""" host: str port: int environment: str database_url: str session_ttl_seconds: int idempotency_ttl_seconds: int instance_id: str cursor_secret: bytes 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 def secret(name: str, file_name: str) -> bytes: 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 encoded = result.encode("utf-8") if len(encoded) < 32: raise ValueError(f"{name} должен содержать не менее 32 байт") return encoded 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") instance_id = value("INSTANCE_ID") or os.uname().nodename if not instance_id: raise ValueError("INSTANCE_ID не может быть пустым") idempotency_ttl_seconds = number("IDEMPOTENCY_TTL_SECONDS", 86400) if idempotency_ttl_seconds < 86400: raise ValueError("IDEMPOTENCY_TTL_SECONDS должен быть не менее 86400") return Settings( host=host, port=port, environment=environment, database_url=database_url, session_ttl_seconds=number("SESSION_TTL_SECONDS", 3600), idempotency_ttl_seconds=idempotency_ttl_seconds, instance_id=instance_id, cursor_secret=secret("CURSOR_SECRET", "CURSOR_SECRET_FILE"), )