Files
mtusi2026lab5/src/config.py
T
2026-10-26 10:05:24 +03:00

123 lines
4.5 KiB
Python

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"),
)