FastAPI இல் Pydantic மாதிரிகள் என்றால் என்ன?

Question

Accepted Answer

**Pydantic மாதிரிகள்** (`BaseModel` இலிருந்து பெறப்பட்ட) வகுப்புகளாகும், அவை தரவுக்கான **கட்டமைப்பு, வகைகள் மற்றும் சரிபார்ப்பு விதிகளை** வரையறுக்கின்றன. FastAPI அவற்றை எல்லா இடங்களிலும் பயன்படுத்துகிறது — கோரிக்கை본문களுக்கு, பதில் வடிவங்களுக்கு மற்றும் அமைப்புகளுக்கு — அவற்றை அதன் வகை-இயக்கப்படும் வடிவமைப்பின் மையமாக மாற்றுகிறது.

## மாதிரியை வரையறுத்தல்

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

ஒவ்வொரு புலமும் ஒரு வகை மற்றும் விருப்ப கட்டுப்பாடுகள்/இயல்புநிலைகளை அறிவிக்கிறது. Pydantic இந்த வரையறையின் எதிரொலியில் தரவை சரிபார்க்கிறது மற்றும் அர்த்தமுள்ளவாறு வகைகளை மாற்றுகிறது.

## தானியங்கி சரிபார்ப்பு மற்றும் பিரித்தல்

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

முயற்சி வகையாக பயன்படுத்தப்படும் போது, FastAPI JSON கோரிக்கை本文ை மாதிரியாக பிரித்து, **ஒவ்வொரு புலத்தையும் சரிபார்த்து** மற்றும் சரியாக இல்லாதவற்றை பட்டியலிடும் கட்டமைப்புத் திரற்ற 422 பிழையை வழங்குகிறது — அனைத்தும் தானியங்கி.

## Pydantic உங்களுக்கு என்ன தருகிறது

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

## உண்மையின் ஒரு ஆதாரம்

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

## ஏன் இது முக்கியம்

Pydantic மாதிரிகள் FastAPI இன் கோணல் — உங்கள் API ஏற்றுக்கொள்ளும் மற்றும் திரும்பக்கொள்ளும் தரவை வரையறுக்கவும் சரிபார்க்கவும் இவ்வாறு, மற்றும் கிட்டத்தட்ட அனைத்து FastAPI பயணாய்வு அவற்றின் மூலம் பாயும்.

அவற்றைப் புரிந்துகொள்வது அவசியம், ஏனெனில் அவை தானியங்கி **சரிபார்ப்பு** (பாதுகாப்பு மற்றும் உறுதிமையுடையதாக இருப்பது — எந்தவொரு கட்டுப்பற்ற உள்ளீட்டை நம்பக்கூடாது), பிரித்தல்/கட்டாயப்படுத்தல், தொடர்பாக்கல் மற்றும் ஆசிரியர் ஆதரவு, ஒரு பெற்றோர் அறிக்கை வகுப்பு থেকে அனைத்து தருகிறது.

அவை **உண்மையின் ஒரு ஆதாரம்** என்று செயல்படுகிறது: ஒரு மாதிரி கோரிக்கை சரிபார்ப்பு, பதில் வடிவம் மற்றும் தானியங்கி-உற்பந்ন ஆவணை இயக்குகிறது.

இந்த வகை-இயக்கப்படும், சரிபார்க்கவும்-இயல்பாக அணுகுமுறை — வலுவான உள்ளீட்டு சரிபார்ப்பு மற்றும் স்পষ்ட பிழை செய்திகளை அடிப்படையில் இலவசம் பெறுதல் — FastAPI அதனால் உত்பादக்கமாகவும் பாதுகாப்பாகவும் இருப்பதற்கான முக்கிய காரணம், Pydantic மாதிரிகளை அடிப்படை, கட்டாய-கற்றல் அறிவாக மாற்றுவது.