Πώς διαχειρίζεστε τις ρυθμίσεις με το Pydantic;

Question

Accepted Answer

Οι εφαρμογές FastAPI διαχειρίζονται τη διαμόρφωση με **`pydantic-settings`** (`BaseSettings`) — μια κλάση που διαβάζει τη config από **μεταβλητές περιβάλλοντος** (και αρχεία `.env`) με **επικύρωση και μετατροπή τύπου**, διατηρώντας τα μυστικά έξω από τον κώδικα και διασφαλίζοντας ότι η config είναι σωστή κατά την εκκίνηση.

## Ορισμός ρυθμίσεων

```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` διαβάζει αυτόματα κάθε πεδίο από μια αντίστοιχη **μεταβλητή περιβάλλοντος** (π.χ. `DATABASE_URL`), μετατρέπει τύπους (`"true"` → `bool`, `"10"` → `int`) και **επικυρώνει** — μια ελλείπουσα απαιτούμενη τιμή ή λάθος τύπος αποτυγχάνει αμέσως κατά την εκκίνηση με σαφές σφάλμα (fail-fast).

## Χρήση ρυθμίσεων (μέσω εγχύσεως εξάρτησης)

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

Η ένεση ρυθμίσεων μέσω μιας δεδομένης εξάρτησης τις κάνει **δοκιμάσιμες** (παράκαμψη σε δοκιμές) και διασφαλίζει μια μόνο παρουσία.

## Το αρχείο .env και τα μυστικά

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

## Γιατί είναι σημαντικό

Η σωστή διαχείριση ρυθμίσεων είναι τόσο ένας **λειτουργικός imperative** (οι εφαρμογές χρειάζονται διαφορετική config σε dev/staging/production) όσο και ένας **απαίτηση ασφάλειας** (τα μυστικά όπως οι διευθύνσεις URL βάσης δεδομένων και τα κλειδιά δεν πρέπει ποτέ να είναι hardcoded στον έλεγχο πηγής — μια συνηθισμένη, σοβαρή παραβίαση).

Το `BaseSettings` του Pydantic παρέχει την ιδιωματική λύση FastAPI, και η κατανόησή του είναι σημαντική καθημερινή γνώση.

Τα βασικά του πλεονεκτήματα: ανάγνωση config από **μεταβλητές περιβάλλοντος** (διατήρηση μυστικών έξω από τον κώδικα, the twelve-factor approach) με αυτόματη **μετατροπή τύπου και επικύρωση** — άρα η λανθασμένη διαμόρφωση αποτυγχάνει γρήγορα κατά την εκκίνηση με σαφές σφάλμα αντί για ένα ασαφές σφάλμα χρόνου εκτέλεσης.

Σε συνδυασμό με την ένεση εξάρτησης (που κάνει τις ρυθμίσεις δοκιμάσιμες και singleton) και την πρακτική gitignored αρχείων `.env` για τοπική ανάπτυξη, αυτό σας δίνει ασφαλή, επικυρωμένη, κατάλληλη περιβάλλοντος διαμόρφωση.

Η γνώση του πώς να ορίζετε ρυθμίσεις, να τις χρησιμοποιείτε μέσω DI και να χειρίζεστε τα μυστικά με ασφάλεια είναι θεμελιώδες για την κατασκευή εφαρμογών FastAPI έτοιμες για παραγωγή.