Si shkruani validim të personalizuar në Pydantic?

Question

Accepted Answer

Përtej kufizimeve të ndërtimit, Pydantic ju lejon të shkruani **logjikën e validimit të personalizuar** me validatorë fushe (validimet një fushë) dhe validatorë modeli (validimet nëpër fusha të shumta) — për rregulla që kufizimet e thjeshta nuk mund t'i shprehin. (Sintaksa e paraqitur është Pydantic v2.)

## Validatorë fushe — validimet/transformimi i një fushe të vetme

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

Një `@field_validator` ekzekuton logjikën e personalizuar në një fushë: ngrini `ValueError` për të refuzuar hyrjen e pavlefshme (FastAPI e shndërron atë në një përgjigje 422 të qartë), ose ktheni një vlerë të transformuar (p.sh. normalizimin në shkronja të vogla).

## Validatorë modeli — validim nëpër fusha

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

Një `@model_validator(mode="after")` ekzekutohet pasi të gjitha fushat janë validuar, me qasje në të gjithë modelin — përdoret për rregulla që përfshijnë **fusha të shumta** (p.sh. konfirmimi që fjalëkalimin përputhen, ose që data e fillimit të jetë përpara datës fundore).

## Validimi i ndërtimit shpesh mjafton në fillim

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

Përzgjedhni kufizimet `Field` dhe lloje të specializuara për rregulla të thjeshta; përdorni validatorë të personalizuar për logjikën e përgjithshme të biznesit.

## Pse ka rëndësi

Validimi i personalizuar i Pydantic është i rëndësishëm për zbatimin e rregullave të biznesit që shkojnë përtej kontrolleve të llojit të thjeshtë dhe kufizimeve — dhe meqenëse validimi është kritik për **sigurinë dhe integritetin e të dhënave**, aftësia për të shprehur çdo rregull është e vlefshme. **Validatorët e fushes** trajtojnë logjikën e fushës së vetme (kontrollet e formatos së personalizuar, normalizimi/transformimi), ndërsa **validatorët e modelit** trajtojnë nevojën e zakonshme për **validim nëpër fusha** (përputhje fjalëkalimi, intervale datash, kërkesa të kushtëzuara) që rregullat në nivel fushe nuk mund t'i shprehin.

Validatorët integrohen pa probleme me FastAPI — një `ValueError` i ngritur bëhet një përgjigje 422 e qartë automatikisht.

Përqasja se kur të përdorni kufizimet/llojet e ndërtimit (për rregulla të thjeshta) versus validatorë të personalizuar (për logjikën e përgjithshme të biznesit), dhe si ndryshojnë validatorët e fushes nga ato të modelit, ju lejon të siguroheni se të dhënat ardhëse plotësojnë plotësisht kërkesat e aplikacionit tuaj, duke e bërë këtë njohuri të rëndësishme për ndërtimin e API-ve të forta dhe të sakta.