FastAPI मा Pydantic models के हुन्?

Question

Accepted Answer

**Pydantic models** `BaseModel` को subclass गरी बनाइएका classes हुन् जो डेटाको **संरचना, प्रकार, र validation rules** परिभाषित गर्छन्। FastAPI ले तिनलाई जताततै प्रयोग गर्छ — request bodies, response shapes, र settings को लागि — जसले तिनलाई यसको type-driven design को हृदय बनाउँछ।

## Model परिभाषित गर्दै

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

प्रत्येक field ले type र optional constraints/defaults घोषणा गर्छ। Pydantic यो परिभाषा विरुद्ध डेटा validate गर्छ र जहाँ समझदारीपूर्ण हुन्छ वहाँ प्रकार रूपान्तरण गर्छ।

## स्वचालित validation र parsing

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

जब parameter type को रूपमा प्रयोग गरिन्छ, FastAPI JSON request body लाई model मा parse गर्छ, **हरेक field को validation गर्छ** र त्यहाँ के गलत छ त्यो सटीकसँग सूचीबद्ध गरी structured 422 error फर्काउँछ — सबै स्वचालित।

## 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 models FastAPI को आधारशिला हुन् — यो तपाईको API ले स्वीकार गरी फर्काउने डेटा कसरी परिभाषित र validate गरिन्छ, र लगभग सबै FastAPI features तिनको माध्यमबाट जान्छ।

tिनलाई बुझ्नु आवश्यक छ किनभने तिनले स्वचालित **validation** (सुरक्षा र मजबुतीको लागि महत्त्वपूर्ण — कहिल्यै raw input मा विश्वास नगर्दै), parsing/coercion, serialization, र editor support प्रदान गर्छन्, सबै एकै घोषणात्मक class बाट।

तिनले **एकै स्रोत को सत्य** को रूपमा काम गर्छन्: एकै model ले request validation, response shape, र auto-generated documentation चलाउँछ।

यो type-driven, validate-by-default approach — robust input validation र स्पष्ट error messages अनिवार्य रूपमा मुक्तमा पाउँदै — FastAPI लाई इतना उत्पादनशील र सुरक्षित बनाउने मुख्य कारण हो, Pydantic models लाई मौलिक, अवश्य-माहिर ज्ञान बनाँदै।