Kaip valdote nustatymus naudojant Pydantic?

Question

IT Interview Practice · Accepted Answer

FastAPI programos konfigūraciją valdo **`pydantic-settings`** (`BaseSettings`) — klasė, kuri skaito konfigūraciją iš **aplinkos kintamųjų** (ir `.env` failų) su **validacija ir tipo konversija**, išlaikydama paslaptis iš kodo ir užtikrinant, kad konfigūracija yra teisinga paleistime.

## Nustatymų nustatymas

```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` automatiškai skaito kiekvieną lauką iš atitinkamo **aplinkos kintamojo** (pvz. `DATABASE_URL`), konvertuoja tipus (`"true"` → `bool`, `"10"` → `int`) ir **valida** — trūkstanti reikalinga reikšmė arba netinkamas tipas iš karto nepavyksta paleistime su aiškia klaida (greitai nepavykti).

## Nustatymų naudojimas (per priklausomybės injektavimą)

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

Nustatymų injektavimas per cache'intą priklausomybę juos daro **testuotinus** (perrašyti testuose) ir užtikrina vieną egzempliorių.

## `.env` failas ir paslapys

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

## Kodėl tai svarbu

Tinkamai nustatymų valdymas yra tiek **operacinė būtinybė** (programos reikalauja skirtingos konfigūracijos dev/staging/production aplinkose), tiek **saugumo reikalavimas** (paslapys, pavyzdžiui, duomenų bazės URL'ai ir raktai, niekada neturi būti užkoduoti šaltinio kontrolėje — tai dažna ir rimta saugumo pažeista).

Pydantic's `BaseSettings` suteikia idiomatinį FastAPI sprendimą, ir suprasti jį yra svarbi kasdieninė žinias.

Jo pagrindiniai privalumai: konfigūracijos skaitymas iš **aplinkos kintamųjų** (paslaptys išliekamos iš kodo, dvylikos veiksnių metodas) su automatiniu **tipo konversija ir validacija** — taigi blogas konfigūravimas greitai nepavyksta paleistime su aiškia klaida, o ne painu runtime nesėkme.

Suderinus su priklausomybės injektavimu (nustatymų testavimu ir singleton'u) ir gitignored `.env` failų praktika vietinei plėtrai, tai suteikia jums saugią, validuotą, aplinkai tinkamą konfigūraciją.

Žinoti, kaip nustatyti nustatymus, juos naudoti per DI ir saugiai tvarkyti paslaptis, yra esmingas elementas kuriant gamybai paruoštas FastAPI programas.

Nustatymų nustatymas

Nustatymų naudojimas (per priklausomybės injektavimą)

.env failas ir paslapys

Kodėl tai svarbu

Susiję klausimai

`.env` failas ir paslapys