A FastAPI alkalmazások a pydantic-settings (BaseSettings) segítségével kezelik a konfigurációt — egy osztály, amely környezeti változókat (és .env fájlokat) olvas be , a titkokat a kódon kívül tartja és biztosítja, hogy a konfiguráció helyes az induláskor.
from pydantic_settings import BaseSettings
class Settings(BaseSettings):
app_name: str = "My API"
database_url: str # required — must be provided
secret_key: str # required (a secret)
debug: bool = False
max_connections: int = 10
class Config:
env_file = ".env" # also read from a .env file
settings = Settings() # reads & VALIDATES env vars at startup
A BaseSettings automatikusan beolvassa az egyes mezőket a megfelelő környezeti változóból (például DATABASE_URL), átalakítja a típusokat ("true" → bool, "10" → int), és érvényesít — a hiányzó kötelező érték vagy helytelen típus azonnal meghibásodik az induláskor, világos hibüzenettel (fail-fast).
from functools import lru_cache
from fastapi import Depends
@lru_cache # create the Settings once (cached)
def get_settings():
return Settings()
@app.get("/info")
def info(settings: Settings = Depends(get_settings)):
return {"app": settings.app_name, "debug": settings.debug}
A beállítások gyorsítótározott függőségen keresztüli injektálása tesztelhető legyen (felülírás a tesztekben) és egyetlen példányt biztosít.
# .env — local config, GITIGNORED (never commit secrets)
DATABASE_URL=postgresql://localhost/mydb
SECRET_KEY=dev-secret
DEBUG=true
✓ Keep secrets in env vars / .env (gitignored); commit a .env.example documenting keys
✓ In production, inject config via the platform's environment / secret manager
✓ Validation at startup catches misconfiguration immediately (not deep in a request)
A megfelelő beállítások kezelése egyrészt operatív szükséglet (az alkalmazásoknak eltérő konfiguráció szükséges a dev/staging/production között), másrészt biztonsági követelmény (az adatbázis URL-ek és kulcsok soha nem merevíthetők a verziókezelésbe — gyakori, súlyos adatszerzés).
A Pydantic BaseSettings biztosítja az idiomatikus FastAPI megoldást, és megértése fontos mindennapi tudás.
Fő előnyei: konfiguráció olvasása környezeti változókat (titkok megtartása a kódon kívül, a tizenkét faktoros megközelítés) automatikus típuskonverzióval és validációval — így a helytelen konfiguráció gyorsan meghibásodik az induláskor, világos hibüzenettel, ahelyett hogy zavaros futásidejű hibával járna.
A függőség-injekció (beállítások tesztelhetővé és singleton-ná tétele) és a helyi fejlesztésre vonatkozó gitignored .env fájlok gyakorlatával kombinálva biztonságos, validált, környezethez igazított konfigurációt biztosít.
Annak tudása, hogyan kell beállításokat definiálni, DI-n keresztül használni és titkokat biztonságosan kezelni, alapvető a termelésre kész FastAPI alkalmazások fejlesztéséhez.