Si menaxhoni cilësimet me Pydantic?

Question

Accepted Answer

Aplikacionet FastAPI menaxhojnë konfigurimin me **`pydantic-settings`** (`BaseSettings`) — një klasë që lexon konfigurimin nga **variablat e mjedisit** (dhe skedarët `.env`) me **validim dhe konvertim tipesh**, duke mbajtur sekretet jashtë kodit dhe duke siguruar që konfigurimi të jetë i saktë në nisje.

## Përcaktimi i cilësimeve

```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` lexon automatikisht çdo fushë nga një **variabël mjedisi** përkatëse (p.sh. `DATABASE_URL`), konverton tipet (`"true"` → `bool`, `"10"` → `int`), dhe **validon** — një vlerë e kërkuar që mungon ose tip i gabuar dështon menjëherë në nisje me një gabim të qartë (dështim-i shpejtë).

## Përdorimi i cilësimeve (përmes injeksionit të varësisë)

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

Injeksioni i cilësimeve përmes një varësie në cache i bën ato **të testueshme** (anulojeni në teste) dhe siguron një instancë të vetme.

## Skedarë .env dhe sekretet

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

## Pse ka rëndësi

Menaxhimi i duhur i cilësimeve është si një **domosdoshmëri operative** (aplikacionet kanë nevojë për konfiguracion të ndryshëm në dev/staging/production) ashtu edhe një **kërkesë sigurimi** (sekretet si URL-et e bazës së të dhënave dhe çelësat nuk duhet të jenë kurrë të hardkoduar në kontroll të burimeve — një shkelje e zakonshme dhe serioze).

`BaseSettings` i Pydantic ofron zgjidhjen idomatiike të FastAPI, dhe kuptimi i saj është njohuri e rëndësishme të përditshme.

Avantazhet e saj kryesore: leximi i konfigurimit nga **variablat e mjedisit** (duke mbajtur sekretet jashtë kodit, qasja me dymbëdhjetë faktor) me **konvertim dhe validim të llojit automatik** — kështu që misproblemi i konfigurimit dështon shpejt në nisje me një gabim të qartë në vend që të ndodhë si një dështim konfuze në kohën e ekzekutimit.

Gjithashtu me injeksionin e varësisë (duke bërë cilësimet të testueshme dhe singleton) dhe praktikën e skedarëve `.env` të injoruar për zhvillimin lokal, kjo ju jep konfigurimin e sigurt, të validuar, të përshtatshëm për mjedisin.

Dija se si të përcaktoni cilësimet, si t'i përdorni ato përmes DI, dhe si të trajtoni sekretet në mënyrë të sigurt është themelore për ndërtimin e aplikacioneve FastAPI të gatshme për prodhim.