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 মডেলগুলিকে মৌলিক, অবশ্য-আয়ত্ত জ্ঞান করে তোলে।