Cad iad na múnlaí Pydantic i FastAPI?

Question

Accepted Answer

**Múnlaí Pydantic** ar fad iad (ag foshonrú ar `BaseModel`) a dhéanann an **struchtúr, na cineálacha, agus na rialacha bailíochtaithe** a shainiú do dhonnta. Úsáideann FastAPI iad i ngach áit — do bhraistintí iarratas, cruthanna freagra, agus socruithe — rud a fhágann gur croílár a dhearaidh atá tiomtha ar chineálacha iad.

## Múnla a shainiú

```python
from pydantic import BaseModel, EmailStr, Field

class User(BaseModel):
    name: str
    email: EmailStr                          # validates email format
    age: int = Field(ge=0, le=120)            # constraint: 0 <= age <= 120
    is_active: bool = True                    # default value
    tags: list[str] = []                      # typed list with a default
```

Déanann gach réimse cineál agus srianta roghnach/réamhshocraithe a dhearbhú. Bailíonn Pydantic donnta i gcoinne an tsainmhínithe seo agus déanann sé cineálacha a thiontú nuair is cuí.

## Bailíochtú agus anailís uathoibríoch

```python
@app.post("/users")
def create_user(user: User):                  # FastAPI builds & validates a User from the body
    return user                               # already validated here
# valid JSON → a typed User object; invalid → automatic 422 with field-level errors
```

Nuair a úsáidtear é mar chineál paraiméadar, anailíseoidh FastAPI a bhraistint iarratas JSON isteach san mhúnla, **ag bailíochtú** gach réimse agus earráid 422 dhéanta ar ais a thairgint ar a bhealach ar bhealach sonrach — ar fad go huathoibríoch.

## Ar dheonaigh Pydantic duit

```text
✓ Validation — type checks + constraints (lengths, ranges, formats), clear errors
✓ Parsing/coercion — "5" → 5, ISO string → datetime, etc.
✓ Serialization — model.model_dump() / model_dump_json() → dict/JSON
✓ Editor support — full autocomplete & type checking on model attributes
✓ Self-documenting — the model defines the schema used in the auto-generated docs
```

## Foinse aonair an fhírinne

```text
One Pydantic model drives: request validation, the response schema, the OpenAPI docs,
and typed access in your code → define the data shape ONCE.
```

## Cén fáth a bhíonn sé tábhachtach

Is iad múnlaí Pydantic an fhondúchlocha FastAPI — seo an chaoi ar shainiú agus ar bhailíochtú tú an donnta a nglacann do API agus a fhilleann sé, agus gluaiseann beagnach gach gné FastAPI tríothu.

Tá sé riachtanach tuiscint a fháil orthu toisc go dtugann siad bailíochtú **uathoibríoch** (ríthábhachtach do chosaint agus cruinneas — gan muinín a bheith agat i nionramh amháin), anailís/coercion, srianadh, agus tacaíocht eagarthóra, ar fad ó rang dearbhaitheach aonair.

Feidhmíonn siad mar **fhoinse aonair an fhírinne** : tiomáineann múnla amháin bailíochtú iarratas, cruth an fhreagra, agus an doiciméadúchán a ghintear go huathoibríoch.

An cur chuige seo atá tiomanta ar chineálacha, bailíochtú de réir réamhshocrú — bailíochtú iontach ionchuir agus teachtaireachtaí earráide soiléire a fháil go bunúsach saor in aisce — cúis mhór atá ann go bhfuil FastAPI chomh táirgiúil agus slán, rud a dhéanann múnlaí Pydantic ina n-eolais bhunúsach, ní mór a bheith i do réaltra.