Kif tikteb validazzjoni personalizzata f'Pydantic?

Question

Accepted Answer

Biex wara l-limitazzjonijiet integrati, Pydantic jippermettilek tikteb **loġika ta' validazzjoni personalizzata** b'field validators (validata field wieħed) u model validators (validata fuq ħafna fields) — għal regoli li limitazzjonijiet sempliċi ma jistgħux jesprimi. (Is-sintassi murija hija Pydantic v2.)

## Field validators — validata/ittrasfurma field wieħed

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

A `@field_validator` iddur loġika personalizzata fuq field: itla' `ValueError` biex tirrifjuta input invalidu (FastAPI ibdilha f'risposta ċara 422), jew irrid valur trasformat (eż. normalizzazzjoni għal lowercase).

## Model validators — validazzjoni cross-field

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

A `@model_validator(mode="after")` iddur wara kollha l-fields ikun validat, b'aċċess għall-mudell sħiħ — użat għal regoli li jinvolvu **ħafna fields** (eż. ikkonfirma li l-passwords jaqblu, jew li data tal-bidu taqbel qabel data ta' tmiem).

## Validazzjoni integrata ħafna drabi tagħmel il-ħaġa l-ewwel

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

Ippreferi limitazzjonijiet `Field` u tipi speċjalizzati għal regoli sempliċi; uża validators personalizzati għal loġika negozjali genuina.

## Għaliex dan importanti

Validazzjoni personalizzata Pydantic hija importanti għad-dħul ta' regoli negozjali li għandhom wara verifiki ta' tip sempliċi u limitazzjonijiet — u billi validazzjoni hija kritika għas-**sigurtà u integrità tad-data**, il-kapaċità li tqiegħed kwalunkwe regola hija valvola. **Field validators** jimtieżu loġika single-field (verifiki ta' format personalizzat, normalizzazzjoni/trasformazzjoni), filwaqt li **model validators** jimtieżu l-ħtieġa komuni għal **validazzjoni cross-field** (passwords jaqblu, firxiet tad-data, rekwiziti kundizzjonali) li regoli ta' livell ta' field ma jistgħux jesprimi.

Il-validators jintegraw b'mod lixx ma' FastAPI — `ValueError` miżmuwa ssiħħ idur risposta 422 ċara awtomatikament.

L-fahim ta' meta tuża limitazzjonijiet/tipi integrati (għal regoli sempliċi) kuntrast ma' validators personalizzati (għal loġika negozjali genuina), u kif field validators u model validators huma differenti, iħallak tikkonferma li d-data tad-dħul tissodisfa kompletament ir-rekwiziti tal-applikazzjoni tiegħek, jagħmel dan għarif importanti għall-ibini ta' APIs qawwija u korretta.