Unaandikaje uthibitishaji maalum (custom validation) katika Pydantic?

Question

Accepted Answer

Zaidi ya vikwazo vilivyojengwa ndani, Pydantic inakuruhusu kuandika **mantiki maalum ya uthibitishaji** ukitumia field validators (kuthibitisha sehemu moja) na model validators (kuthibitisha katika sehemu kadhaa) — kwa sheria ambazo vikwazo rahisi haviwezi kueleza. (Sintaksia iliyoonyeshwa ni ya Pydantic v2.)

## Field validators — thibitisha/badilisha sehemu moja

```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` huendesha mantiki maalum kwenye sehemu: inua `ValueError` ili kukataa ingizo batili (FastAPI huibadilisha kuwa hitilafu wazi 422), au rudisha thamani iliyobadilishwa (k.m. kurekebisha kuwa herufi ndogo).

## Model validators — uthibitishaji wa sehemu mtambuka

```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")` huendesha baada ya sehemu zote kuthibitishwa, ikiwa na ufikiaji wa modeli nzima — hutumika kwa sheria zinazohusisha **sehemu nyingi** (k.m. kuthibitisha nywila zinalingana, au kwamba tarehe ya kuanza inatangulia tarehe ya kumalizika).

## Uthibitishaji uliojengwa ndani mara nyingi unatosha kwanza

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

Pendelea vikwazo vya `Field` na aina maalum kwa sheria rahisi; tumia validators maalum kwa mantiki halisi ya biashara.

## Kwa nini ni muhimu

Uthibitishaji maalum wa Pydantic ni muhimu kwa kutekeleza sheria za biashara zinazoenda zaidi ya ukaguzi rahisi wa aina na vikwazo — na kwa kuwa uthibitishaji ni muhimu kwa **usalama na uadilifu wa data**, kuweza kueleza sheria yoyote ni jambo la thamani. **Field validators** hushughulikia mantiki ya sehemu moja (ukaguzi maalum wa muundo, urekebishaji/ubadilishaji), wakati **model validators** hushughulikia hitaji la kawaida la **uthibitishaji wa sehemu mtambuka** (nywila kulingana, masafa ya tarehe, mahitaji ya masharti) ambayo sheria za kiwango cha sehemu haziwezi kueleza.

Validators hujumuika kwa urahisi na FastAPI — `ValueError` iliyoinuliwa huwa jibu wazi 422 kiotomatiki.

Kuelewa wakati wa kutumia vikwazo/aina zilizojengwa ndani (kwa sheria rahisi) dhidi ya validators maalum (kwa mantiki halisi ya biashara), na jinsi field validators dhidi ya model validators zinavyotofautiana, kunakuwezesha kuhakikisha data inayoingia inatimiza kikamilifu mahitaji ya programu yako, jambo linalofanya haya kuwa maarifa muhimu ya kujenga API imara na sahihi.