103 lines
3.7 KiB
Python
103 lines
3.7 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",
|
|
"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",
|
|
)
|