Kako napišete lastno validacijo v Pydanticu?

Question

Accepted Answer

Poleg vgrajenih omejitev vam Pydantic omogoča pisanje **lastne logike validacije** s field validatorji (validacija enega polja) in model validatorji (validacija na več poljih) — za pravila, ki jih preproste omejitve ne morejo izraziti. (Sintaksa prikazana je za Pydantic v2.)

## Field validatorji — validacija/transformacija polja

```python
from pydantic import BaseModel, field_validator

class User(BaseModel):
    username: str
    password: str

@field_validator("username")
    @classmethod
    def username_alphanumeric(cls, v: str) -> str:
        if not v.isalnum():
            raise ValueError("username must be alphanumeric")   # → a 422 error
        return v.lower()                                         # can also TRANSFORM the value
```

`@field_validator` izvede lastno logiko na polju: dvigni `ValueError` za zavrnitev neveljavnega vnosa (FastAPI ga spremeni v jasen 422), ali vrni transformirano vrednost (npr. normalizacija na male črke).

## Model validatorji — validacija med polji

```python
from pydantic import model_validator

class SignupForm(BaseModel):
    password: str
    confirm_password: str

@model_validator(mode="after")
    def passwords_match(self):
        if self.password != self.confirm_password:    # compare MULTIPLE fields
            raise ValueError("passwords do not match")
        return self
```

`@model_validator(mode="after")` se zažene po validaciji vseh polj, z dostopom do celotnega modela — uporablja se za pravila, ki vključujejo **več polj** (npr. potrditev ujemanja gesel ali da datum začetka predhodi datumu konca).

## Vgrajena validacija pogosto zadostuje na začetku

```python
class Product(BaseModel):
    price: float = Field(gt=0)          # use Field constraints for simple rules
    sku: str = Field(pattern=r"^[A-Z]{3}-\d+$")
    email: EmailStr                      # specialized types for formats
# reach for custom validators only when constraints/types can't express the rule
```

Prednostno izberite `Field` omejitve in posebne tipe za preprosta pravila; uporabite lastne validatorje za resnično poslovno logiko.

## Zakaj je to pomembno

Lastna Pydantic validacija je pomembna za uveljavljanje poslovnih pravil, ki presegajo preproste preverjanje tipov in omejitve — in ker je validacija kritična za **varnost in integriteto podatkov**, je sposobnost izražanja katerega koli pravila dragocena. **Field validatorji** obdelujejo logiko enega polja (preverke lastne oblike, normalizacija/transformacija), medtem ko **model validatorji** obdelujejo pogosto potrebo za **validacijo med polji** (ujemanje gesel, obsegi datumov, pogojne zahteve), ki je ne morejo izraziti pravila na ravni polja.

Validatorji se brezhibno integrirajo s FastAPI — dvignjen `ValueError` se samodejno spremeni v jasen odgovor 422.

Razumevanje, kdaj uporabiti vgrajene omejitve/tipe (za preprosta pravila) nasproti lastnim validatorjem (za resnično poslovno logiko) ter kako se razlikujejo field in model validatorji, vam omogoči zagotavljanje, da vstopni podatki popolnoma izpolnjujejo zahteve vaše aplikacije, kar to znanje dela pomembno za gradnjo robustnih in pravilnih API-jev.