Pydantic এ আপনি কীভাবে কাস্টম ভ্যালিডেশন লিখবেন?

Question

Accepted Answer

বিল্ট-ইন সীমাবদ্ধতার বাইরে, Pydantic আপনাকে **কাস্টম ভ্যালিডেশন লজিক** লিখতে দেয় field validators (একটি ফিল্ড ভ্যালিডেট করুন) এবং model validators (একাধিক ফিল্ড জুড়ে ভ্যালিডেট করুন) দিয়ে — সাধারণ সীমাবদ্ধতা প্রকাশ করতে পারে না এমন নিয়মগুলির জন্য। (এখানে দেখানো সিন্ট্যাক্স Pydantic v2।)

## Field validators — একটি একক ফিল্ড ভ্যালিডেট/ট্রান্সফর্ম করুন

```python
from pydantic import BaseModel, field_validator

class User(BaseModel):
    username: str
    password: str

@field_validator("username")
    @classmethod
    def username_alphanumeric(cls, v: str) -> str:
        if not v.isalnum():
            raise ValueError("username must be alphanumeric")   # → a 422 error
        return v.lower()                                         # can also TRANSFORM the value
```

একটি `@field_validator` একটি ফিল্ডে কাস্টম লজিক চালায়: অবৈধ ইনপুট প্রত্যাখ্যান করতে `ValueError` উত্থাপন করুন (FastAPI এটিকে একটি স্পষ্ট 422-এ পরিণত করে), অথবা একটি রূপান্তরিত মান ফেরত দিন (যেমন লোয়ারকেসে নরমালাইজ করা)।

## Model validators — ক্রস-ফিল্ড ভ্যালিডেশন

```python
from pydantic import model_validator

class SignupForm(BaseModel):
    password: str
    confirm_password: str

@model_validator(mode="after")
    def passwords_match(self):
        if self.password != self.confirm_password:    # compare MULTIPLE fields
            raise ValueError("passwords do not match")
        return self
```

একটি `@model_validator(mode="after")` সমস্ত ফিল্ড ভ্যালিডেট করার পরে চলে, সম্পূর্ণ মডেলে অ্যাক্সেস সহ — **একাধিক ফিল্ড** জড়িত নিয়মের জন্য ব্যবহৃত হয় (যেমন নিশ্চিত করা যে পাসওয়ার্ডগুলি মেলে, বা যে একটি শুরুর তারিখ একটি শেষ তারিখের আগে আসে)।

## বিল্ট-ইন ভ্যালিডেশন প্রায়শই প্রথমে যথেষ্ট

```python
class Product(BaseModel):
    price: float = Field(gt=0)          # use Field constraints for simple rules
    sku: str = Field(pattern=r"^[A-Z]{3}-\d+$")
    email: EmailStr                      # specialized types for formats
# reach for custom validators only when constraints/types can't express the rule
```

সাধারণ নিয়মের জন্য `Field` সীমাবদ্ধতা এবং বিশেষায়িত প্রকার পছন্দ করুন; প্রকৃত ব্যবসায়িক লজিকের জন্য কাস্টম validators ব্যবহার করুন।

## কেন এটি গুরুত্বপূর্ণ

কাস্টম Pydantic ভ্যালিডেশন ব্যবসায়িক নিয়মগুলি প্রয়োগ করার জন্য গুরুত্বপূর্ণ যা সাধারণ টাইপ চেক এবং সীমাবদ্ধতার বাইরে চলে যায় — এবং যেহেতু ভ্যালিডেশন **নিরাপত্তা এবং ডেটা অখণ্ডতার** জন্য গুরুত্বপূর্ণ, যেকোনো নিয়ম প্রকাশ করতে সক্ষম হওয়া মূল্যবান। **Field validators** একক-ফিল্ড লজিক পরিচালনা করে (কাস্টম ফরম্যাট চেক, নরমালাইজেশন/ট্রান্সফর্মেশন), যখন **model validators** সাধারণ প্রয়োজন পরিচালনা করে **ক্রস-ফিল্ড ভ্যালিডেশনের** জন্য (পাসওয়ার্ডগুলি মেলানো, তারিখ রেঞ্জ, শর্তসাপেক্ষ প্রয়োজনীয়তা) যা ফিল্ড-লেভেল নিয়মগুলি প্রকাশ করতে পারে না।

validators FastAPI-এর সাথে নির্বিঘ্নে একীভূত হয় — একটি উত্থাপিত `ValueError` স্বয়ংক্রিয়ভাবে একটি স্পষ্ট 422 প্রতিক্রিয়া হয়ে ওঠে।

বিল্ট-ইন সীমাবদ্ধতা/প্রকারগুলি (সাধারণ নিয়মের জন্য) বনাম কাস্টম validators (বাস্তব ব্যবসায়িক লজিকের জন্য) কখন ব্যবহার করতে হয় তা বোঝা, এবং কীভাবে field বনাম model validators পার্থক্য করে, আপনাকে নিশ্চিত করতে দেয় যে আসন্ন ডেটা আপনার অ্যাপ্লিকেশনের প্রয়োজনীয়তা সম্পূর্ণরূপে সন্তুষ্ট করে, এটি শক্তিশালী, সঠিক APIs তৈরির জন্য গুরুত্বপূর্ণ জ্ঞান করে তোলে।