FastAPI मधील Pydantic models म्हणजे काय?

Question

Accepted Answer

**Pydantic models** ही वर्ग आहेत (जी `BaseModel` ला subclass करतात) जी डेटाचे **structure, types, आणि validation rules** परिभाषित करतात. FastAPI हे सर्वत्र वापरतो — request bodies, response shapes, आणि settings साठी — ज्यामुळे ते तिच्या type-driven design चे हृदय बनतात.

## मॉडेल परिभाषित करणे

```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 एक प्रकार आणि वैकल्पिक 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 ला मॉडेलमध्ये parse करते, **प्रत्येक field validate** करते आणि नेमकी काय चूक आहे याची यादी देणारी 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 feature यांच्यातून प्रवाहित होतो.

त्यांना समजून घेणे आवश्यक आहे कारण ते आपोआप **validation** (सुरक्षा आणि मजबूतपणासाठी गंभीर — कधीही raw input वर विश्वास न करता), parsing/coercion, serialization, आणि editor support प्रदान करतात, सर्व एक single declarative class मधून.

ते एक **एकमेव सत्य स्रोत** म्हणून काम करतात: एक मॉडेल request validation, response shape, आणि auto-generated documentation चालवते.

हा type-driven, validate-by-default दृष्टिकोन — robust input validation आणि स्पष्ट error messages अत्यंत कमी खर्चात मिळणे — हे FastAPI इतके productive आणि safe असण्याचे मुख्य कारण आहे, ज्यामुळे Pydantic models fundamental, must-master ज्ञान बनतात.