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 మోడల్‌లను మూల, అవసరమైన-సాధన జ్ఞానం చేస్తుంది.