L-applikazzjonijiet FastAPI jimmaniġġu l-konfigurazzjoni b'pydantic-settings (BaseSettings) — klassi li taqra config minn varjabbli ta' ambjent (u mill-fajls .env) b', u żżommhom is-sikerezzajn 'il barra mill-kodiċi u żżomm il-konfigurazzjoni korretta fi start-up.
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
BaseSettings taqra awtomatikament kull field minn varjabbli ta' ambjent li taqbel (eż. DATABASE_URL), tikkonverti t-tipuri ("true" → bool, "10" → int), u tivvalida — valur meħtieġ nieqes jew tip żbaljat ifallu mill-ewwel fi start-up b'żball ċar (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}
L-injezzjoni tas-settings permezz ta' dipendenza cached ix-xaqlhom testable (override fit-tests) u żżomm singola istanza.
.env u s-sikerezzajn# .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)
L-immaniġġjar xieraq tas-settings hu kemm neċessità operazzjonali (l-applikazzjonijiet jeħtieġu konfigurazzjoni differenti madwar dev/staging/production) kif ukoll rekwiżit ta' sigurtà (sikerezzajn bħal database URLs u ċavs m'għandhomx qatt ikunu hard-coded fl-kontroll tas-sors — sbieħ komuni u gravi).
Pydantic's BaseSettings tipprovdi s-soluzzjoni idiomatika ta' FastAPI, u l-għarfien tagħha hu importanti għal-għarfien ta' kuljum.
L-avvantaggi ewlenin tiegħa: il-qari tal-config minn varjabbli ta' ambjent (żżommhom is-sikerezzajn 'il barra mill-kodiċi, l-approċċ twelve-factor) b'awtomatika konverżjoni tat-tip u validazzjoni — i.e. l-misconfigurazzjoni taqa' kmieni fi start-up b'żball ċar iżjed milli tkun fallimentu runtime bixxi.
Flimkien ma' dependency injection (agħmel is-settings testable u singleton) u l-praktika tal-fajls .env gitignored għall-iżviluppa lokali, dan jagħtik konfigurazzjoni sigura, validata, u xierqa għall-ambjent.
L-għarfien ta' kif tiddefinisci settings, tuża permezz ta' DI, u timmaniġġja s-sikerezzajn b'mod sigur hu fundamentali għal-bini ta' applikazzjonijiet FastAPI lesti għall-produzzjoni.