FastAPI ਵਿੱਚ Pydantic ਮਾਡਲ ਕੀ ਹਨ?

Question

Accepted Answer

**Pydantic ਮਾਡਲ** ਉਹ ਕਲਾਸਾਂ ਹਨ (`BaseModel` ਦੀਆਂ ਸਬਕਲਾਸਾਂ) ਜੋ ਡੇਟਾ ਦੀ **ਬਣਤਰ, ਕਿਸਮਾਂ, ਅਤੇ ਤਸਦੀਕ ਨਿਯਮ** ਪਰਿਭਾਸ਼ਿਤ ਕਰਦੀਆਂ ਹਨ। FastAPI ਉਹਨਾਂ ਨੂੰ ਹਰ ਥਾਂ ਵਰਤਦਾ ਹੈ — request bodies, response shapes, ਅਤੇ ਸੈਟਿੰਗਜ਼ ਲਈ — ਜਿਸ ਨਾਲ ਉਹ ਇਸ ਦੀ 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 ਇੱਕ type ਅਤੇ optional constraints/defaults ਨੂੰ declare ਕਰਦਾ ਹੈ। Pydantic ਇਸ ਪਰਿਭਾਸ਼ਾ ਦੀ ਬਨਸਪੱਤ ਡੇਟਾ ਦੀ ਤਸਦੀਕ ਕਰਦਾ ਹੈ ਅਤੇ ਜਿੱਥੇ ਸਮਝਦਾਰੀ ਹੋਵੇ ਉਹਾਂ ਕਿਸਮਾਂ ਨੂੰ ਤਬਦੀਲ ਕਰਦਾ ਹੈ।

## ਸਵੈ-ਚਾਲਿਤ ਤਸਦੀਕ ਅਤੇ 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 ਦੀ ਤਸਦੀਕ** ਕਰਦਾ ਹੈ ਅਤੇ ਇੱਕ ਢਾਂਚਾਬੱਧ 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 ਵਿਸ਼ੇਸ਼ਤਾ ਉਨ੍ਹਾਂ ਰਾਹੀਂ ਵਹਿੰਦੀ ਹੈ।

ਉਹਨਾਂ ਨੂੰ ਸਮਝਣਾ ਜ਼ਰੂਰੀ ਹੈ ਕਿਉਂਕਿ ਉਹ ਸਵੈ-ਚਾਲਿਤ **ਤਸਦੀਕ** ਫਰਾਹਮ ਕਰਦੇ ਹਨ (ਸੁਰੱਖਿਆ ਅਤੇ ਮਜ਼ਬੂਤੀ ਲਈ ਮਹੱਤਵਪੂਰਨ — ਕਦੇ ਕੱਚੀ ਇਨਪੁਟ 'ਤੇ ਭਰੋਸਾ ਨਾ ਕਰਨਾ), parsing/coercion, serialization, ਅਤੇ editor ਸਮਰਥਨ, ਸਭ ਇੱਕ ਐਲਾਨੀ ਕਲਾਸ ਤੋਂ।

ਉਹ **ਇੱਕ ਸਰੋਤ ਦਾ ਸੱਚ** ਵਜੋਂ ਕੰਮ ਕਰਦੇ ਹਨ: ਇੱਕ ਮਾਡਲ request ਦੀ ਤਸਦੀਕ, response ਸ਼ਾਪ, ਅਤੇ auto-generated ਦਸਤਾਵੇਜ਼ਾਂ ਨੂੰ ਚਲਾਉਂਦਾ ਹੈ।

ਇਹ type-driven, validate-by-default ਦਾ ਤਰੀਕਾ — ਮਜ਼ਬੂਤ input ਤਸਦੀਕ ਅਤੇ ਸਪੱਸ਼ਟ ਤ੍ਰੁਟੀ ਸੁਨੇਹਾ ਲਗਭਗ ਮੁਫ਼ਤ ਵਿੱਚ ਪ੍ਰਾਪਤ ਕਰਨਾ — ਇਹ ਇੱਕ ਮੁੱਖ ਕਾਰਨ ਹੈ ਕਿ FastAPI ਇਤਨਾ ਲਾਭਕਾਰੀ ਅਤੇ ਸੁਰੱਖਿਅਤ ਹੈ, Pydantic ਮਾਡਲਾਂ ਨੂੰ ਬੁਨਿਆਦੀ, ਜ਼ਰੂਰੀ-ਮਾਸਟਰ ਗਿਆਨ ਬਣਾਉਂਦੇ ਹੋਏ।