FastAPI میں Pydantic ماڈلز کیا ہیں؟

Question

Accepted Answer

**Pydantic ماڈلز** کلاسز ہیں (جو `BaseModel` کو subclass کرتی ہیں) جو ڈیٹا کی **ساخت، اقسام، اور validation rules** کو define کرتی ہیں۔ FastAPI انہیں ہر جگہ استعمال کرتا ہے — request bodies، response shapes، اور settings کے لیے — جو انہیں اس کے type-driven ڈیزائن کا دل بناتا ہے۔

## ماڈل کی تعریف

```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 اور اختیاری constraints/defaults کو declare کرتا ہے۔ Pydantic اس تعریف کے خلاف ڈیٹا کو validate کرتا ہے اور جہاں معقول ہو وہاں types کو convert کرتا ہے۔

## خودکار 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
```

## ایک واحد source of truth

```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 کو قبول اور واپس کرنے والے ڈیٹا کو define اور validate کرتے ہیں، اور تقریباً ہر FastAPI feature ان کے ذریعے جاتا ہے۔
	es ہے کیونکہ وہ خودکار **validation** فراہم کرتے ہیں (سیکیورٹی اور مضبوطی کے لیے ضروری — raw input پر کبھی بھروسہ نہ کریں)، parsing/coercion، serialization، اور editor support، سب ایک declarative class سے۔

وہ **ایک واحد source of truth** کے طور پر کام کرتے ہیں: ایک ماڈل request validation، response shape، اور auto-generated documentation کو drive کرتا ہے۔

یہ type-driven، validate-by-default approach — مضبوط input validation اور واضح error messages بنیادی طور پر مفت میں حاصل کرنا — FastAPI کے بہت نتیجہ خیز اور محفوظ ہونے کی ایک بڑی وجہ ہے، جو Pydantic ماڈلز کو بنیادی، لازمی طور پر سیکھنے کے قابل علم بناتا ہے۔