Conas a scríobhann tú bailíochtú saincheaptha i Pydantic?

Question

Accepted Answer

Thairis ar shrian-oibríochtaí ionsuite, tugann Pydantic deis duit **loighic bhailíochtaithe saincheaptha** a scríobh le bailitheoirí páirc (bailíochtú réimse amháin) agus bailitheoirí samhail (bailíochtú ar fud réimsí iolracha) — do rialacha nach féidir le srian shimplí a chur in iúl. (Soláthraítear an bhreacsolaithríocht do Pydantic v2.)

## Bailitheoirí páirc — bailíochtú/athrú réimse amháin

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

Rithionn `@field_validator` loighic dhosaincheaptha ar réimse: tóg `ValueError` chun ionchur neamhbhailí a dhiúltú (athraíonn FastAPI go 422 soiléir), nó fill luach claochloite (m.sh. normalú go litir dhíbheirte).

## Bailitheoirí samhail — bailíochtú tras-páirc

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

Rithionn `@model_validator(mode="after")` tar éis do gach réimse a bheith bailíochtaithe, agus rochtain ar an tsamhail ar fad — úsáidtear do rialacha a bhaineann le **réimsí iolracha** (m.sh. a dheimhniú go bhfuil focail fhaire ag teacht amach, nó go dtosaíonn dáta tosaigh roimh dhátaithe deireanach).

## Is leor an bhailíochtú ionsuite go minic ar dtús

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

Roghnaigh srianta `Field` agus cineálacha speisialaithe do rialacha simplí; úsáid bailitheoirí saincheaptha do fhíorloighic ghnó.

## Cén fáth a bhíonn tábhacht ann

Tá tábhacht ag baint le bailíochtú Pydantic saincheaptha do rialacha gnó a bhunú ar bharr sheiceanna cineáil shimplí agus srian — agus ós rud é go bhfuil bailíochtú ríthábhachtach do **slándáil agus iomláine sonraí**, tá sé fíorluachmhar a bheith ábalta aon riail a chur in iúl. **Bailitheoirí páirc** a dhéanann loighic réimse singil (seiceanna formáid dhosaincheaptha, normalú/claochlóirí), agus **bailitheoirí samhail** ag déileáil leis an riachtanas coitianta ar **bhailíochtú tras-páirc** (focail fhaire a bhheith ag teacht amach, raonta dátaithe, riachtanais choinníollach) nach féidir le rialacha ag leibhéal páirc a chur in iúl.

Gnóthaíonn na bailitheoirí go fóill le FastAPI — dá bhfoilsiú `ValueError`, déantar freagra soiléir 422 go huathoibríoch.

Tugann tuiscint ar cathain a úsáidtear srianta/cineálacha ionsuite (do rialacha simplí) i gcomhram le bailitheoirí saincheaptha (do loighic ghhnó fíor), agus conas is difriúil bailitheoirí páirc ó bhailitheorí samhail, deis duit a chinntiú go gcomhlíonann an sonraí isteach ar laige do thógálacha feidhmchlár, agus é seo ina eolas tábhachtach do API láidre, ceart a thógáil.