ما الذي تغير في Pydantic v2 ولماذا يهم FastAPI؟

Question

Accepted Answer

**Pydantic v2** (إعادة كتابة شاملة مع نواة **Rust**) جلبت مكاسب أداء كبيرة وتغييرات في API. بما أن Pydantic هو جوهر FastAPI (التحقق من الصحة، والتسلسل، والنماذج)، فإن فهم v2 مهم لكل من السرعة وكتابة الكود الحديث بشكل صحيح.

## العنوان الرئيسي: أسرع بكثير (نواة Rust)

```text
Pydantic v2's validation core (pydantic-core) is written in RUST → typically
5–50x faster validation/serialization than v1.
→ Since FastAPI validates every request and serializes every response with Pydantic,
  this directly speeds up FastAPI apps.
```

هذا هو أكثر التغييرات تأثيراً — التحقق الأسرع يعني FastAPI أسرع، بدون الحاجة لتغييرات في الكود سوى الترقية.

## تغييرات API الرئيسية (v1 → v2)

```python
# method renames
model.dict()        → model.model_dump()          # to a dict
model.json()        → model.model_dump_json()      # to JSON
Model.parse_obj()   → Model.model_validate()        # from a dict

# validator decorators renamed
@validator("field")      → @field_validator("field")    # + must be a @classmethod
@root_validator         → @model_validator(mode="after")  # cross-field

# config: a class Config → model_config dict
class Config: ...        → model_config = ConfigDict(...)
```

تم إعادة تسمية الطرق الشائعة ومزخرفات المدقق — مهم عند قراءة أو كتابة الكود، وعند ترحيل codebases الإصدار v1.

## سلوك أكثر صرامة ووضوحاً

```text
✓ Stricter type coercion by default (fewer surprising silent conversions)
✓ Clearer, more detailed validation errors
✓ Better support for strict vs lax modes, computed fields, serialization control
✓ pydantic-settings split into its own package (BaseSettings moved there)
```

## لماذا هذا مهم لـ FastAPI بالتحديد

```text
FastAPI uses Pydantic for: request body validation, response_model serialization,
query/path validation, settings, and the OpenAPI schema. So Pydantic v2's:
  ✓ speed → faster request handling across the board
  ✓ API changes → you must use the v2 syntax (model_dump, field_validator, etc.)
  ✓ behavior → stricter, more predictable validation
Modern FastAPI versions require/use Pydantic v2.
```

## لماذا يهم

فهم Pydantic v2 مهم لمطوري FastAPI لأن Pydantic هو أساس الميزات الأساسية في FastAPI (التحقق من الصحة، والتسلسل، والنماذج، والإعدادات، والتوثيق)، لذا فإن تغيير الإصدار الرئيسي له يؤثر مباشرة على كل من الأداء وطريقة كتابة الكود.

فائدة العنوان الرئيسي — نواة **قائمة على Rust توفر التحقق والتسلسل أسرع بـ 5–50 مرة** — تسرع مباشرة تطبيقات FastAPI (التي تتحقق من كل طلب وتسلسل كل استجابة من خلال Pydantic)، وهي فائدة أداء كبيرة يتم تحقيقها فقط بالانتقال إلى v2.

وبنفس الأهمية **تغييرات API**: الطرق المعاد تسميتها (`model_dump`/`model_validate`) ومزخرفات المدقق (`field_validator`/`model_validator`) تعني أنه يجب عليك استخدام الصيغة الحديثة لكتابة كود صحيح، وتمييز هذه التغييرات ضروري عند قراءة الكود الحالي، أو كتابة كود جديد، أو ترحيل codebases الإصدار v1 القديم (مهمة شائعة في العالم الحقيقي).

سلوك التحقق الأكثر صرامة ووضوحاً يجعل التطبيقات أكثر قابلية للتنبؤ.

بما أن إصدارات FastAPI الحديثة مبنية على Pydantic v2، فإن معرفة ما تغير — مكاسب الأداء، و API الجديد، والفروقات السلوكية — هي معرفة مستوى كبار مهمة للعمل بفعالية مع FastAPI الحالي، وتجنب أنماط v1 القديمة، وفهم سبب أداء FastAPI كما هو. إنها تعكس الوعي بالأساس المتطور للإطار العملي وتصبح ذات صلة متزايدة مع توحيد النظام البيئي على v2.