from collections.abc import Iterator from sqlalchemy import create_engine from sqlalchemy.orm import DeclarativeBase, Session, sessionmaker from app.config import settings class Base(DeclarativeBase): pass # Pool sized above the sync-endpoint threadpool (~40) so a burst of short DB sessions can't starve on # checkout. The image proxies deliberately DON'T hold a connection during their slow external fetch # (see routes/plex/), so this headroom is only for the many brief sessions, not long ones. engine = create_engine( settings.database_url, pool_pre_ping=True, pool_size=20, max_overflow=30, pool_timeout=30, future=True, # A database error renders its bound parameters into its message — a title, an uploader, a # file path, a URL — and that message is logged and stored as a job's error text. The SQL # stays; the values are data, and the ids an operator needs are on the line already. hide_parameters=True, ) SessionLocal = sessionmaker(bind=engine, autoflush=False, expire_on_commit=False) def get_db() -> Iterator[Session]: db = SessionLocal() try: yield db finally: db.close()