Hvordan administrerer du indstillinger med Pydantic?

Question

Accepted Answer

FastAPI-applikationer administrerer konfiguration med **`pydantic-settings`** (`BaseSettings`) — en klasse, der læser config fra **miljøvariabler** (og `.env`-filer) med **validering og typekonvertering**, hvilket holder hemmeligheder uden for koden og sikrer, at config er korrekt ved opstart.

## Definition af indstillinger

```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` læser automatisk hvert felt fra en matchende **miljøvariabel** (f.eks. `DATABASE_URL`), konverterer typer (`"true"` → `bool`, `"10"` → `int`) og **validerer** — en manglende påkrævet værdi eller forkert type mislykkes øjeblikkeligt ved opstart med en klar fejl (fail-fast).

## Brug af indstillinger (via afhængighedsinjection)

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

Injection af indstillinger via en cached afhængighed gør dem **testbare** (overskriv i tests) og sikrer en enkelt instans.

## .env-filen og hemmeligheder

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

## Hvorfor det betyder noget

Rigtig administrering af indstillinger er både en **operativ nødvendighed** (apps har brug for forskellig config på tværs af dev/staging/production) og et **sikkerhedskrav** (hemmeligheder som databaseURL'er og nøgler må aldrig være hardcoded i source control — en almindelig, alvorlig overtrædelse).

Pydantic's `BaseSettings` giver den idiomatiske FastAPI-løsning, og at forstå det er vigtig daglig viden.

Dets vigtigste fordele: læsning af config fra **miljøvariabler** (holde hemmeligheder uden for kode, the twelve-factor approach) med automatisk **typekonvertering og validering** — så fejlkonfiguration mislykkes hurtigt ved opstart med en klar fejl i stedet for en forvirrende runtime-fejl.

I kombination med afhængighedsinjection (hvilket gør indstillinger testbare og singleton) og praksis med gitignored `.env`-filer til lokal udvikling giver dette dig sikker, valideret, miljøpassende konfiguration.

At vide hvordan man definerer indstillinger, bruger dem via DI og håndterer hemmeligheder sikkert er grundlæggende for at bygge produktionsklare FastAPI-applikationer.