Kako upravljate nastavitve s Pydantic-om?

Question

Accepted Answer

FastAPI aplikacije upravljajo konfiguracije z **`pydantic-settings`** (`BaseSettings`) — razredom, ki bere konfiguracije iz **okoljskih spremenljivk** (in `.env` datotek) z **validacijo in pretvarjanjem tipov**, pri čemer skrivnosti ostanejo zunaj kode in zagotavlja, da je konfiguracija pravilna ob zagonu.

## Opredelitev nastavitev

```python
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` samodejno bere vsako polje iz ustrezne **okoljske spremenljivke** (npr. `DATABASE_URL`), pretvori tipe (`"true"` → `bool`, `"10"` → `int`) in **validira** — manjkajoča zahtevana vrednost ali napačen tip takoj pri zagonu povzroči napako z jasno sporočilo (fail-fast).

## Uporaba nastavitev (prek vbrizgavanja odvisnosti)

```python
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}
```

Vbrizgavanje nastavitev prek predpomnene odvisnosti jih naredi **testabilne** (prepis v testih) in zagotavlja enojno instanco.

## Datoteka .env in skrivnosti

```bash
# .env — local config, GITIGNORED (never commit secrets)
DATABASE_URL=postgresql://localhost/mydb
SECRET_KEY=dev-secret
DEBUG=true
```

```text
✓ 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)
```

## Zakaj je to pomembno

Pravilno upravljanje nastavitev je tako **operativna nujnost** (aplikacije potrebujejo različne konfiguracije za razvojno/vmesno/produkcijsko okolje) kot tudi **varnostna zahteva** (skrivnosti, kot so URL-ji podatkovnih zbirk in ključi, se nikoli ne smejo hardkodirati v nadzoru izvora — pogosta, resna varnostna grožnja).

Pydantic-ov `BaseSettings` zagotavlja idiomatsko FastAPI rešitev, razumevanje pa je pomembno vsakodnevno znanje.

Njegove ključne prednosti: branje konfiguracije iz **okoljskih spremenljivk** (skrivnosti ostanejo zunaj kode, pristop twelve-factor) z avtomatskim **pretvarljem tipov in validacijo** — zato napačna konfiguracija takoj pri zagonu ne uspe z jasno napako, namesto da bi bila nejasna napaka pri izvajanju.

V kombinaciji z vbrizgavanjem odvisnosti (nastavitve testabilne in singleton) in prakso gitignoriranih `.env` datotek za lokalni razvoj to omogoča varno, validirano, konfiguraciji primerno za okolje.

Znanje, kako opredeliti nastavitve, jih uporabiti prek DI in varno ravnati s skrivnostmi, je temelj za gradnjo produkcijsko pripravljenih FastAPI aplikacij.