ما هي أنماط الاعتماديات المتقدمة التي يدعمها FastAPI؟

Question

Accepted Answer

بما يتجاوز `Depends` الأساسي، يدعم حقن الاعتماديات في FastAPI أنماطاً متقدمة: **الاعتماديات الفرعية**، **الاعتماديات ذات المعاملات** (قائمة على الفئات أو عبر المصانع)، **الموارد ذات النطاق المحدد** (yield)، **الاعتماديات العامة/على مستوى الموجه**، و**تجاوز الاعتماديات** للاختبار — مما يجعلها أداة متعددة الاستخدامات لهيكلة التطبيقات الحقيقية.

## الاعتماديات الفرعية (أشجار الاعتماديات)

```python
def get_token(authorization: str = Header()):
    return parse(authorization)

def get_current_user(token: str = Depends(get_token)):   # depends on another dependency
    return decode(token)

def get_admin(user: User = Depends(get_current_user)):    # depends on that, in turn
    if not user.is_admin: raise HTTPException(403)
    return user
# FastAPI resolves the whole chain, caching shared dependencies within a request
```

يمكن للاعتماديات أن تعتمد على اعتماديات أخرى، مما يشكل شجرة يحلها FastAPI تلقائياً (و**يخزن مؤقتاً** الاعتماديات المشتركة لكل طلب، لذلك يعمل `get_token` مرة واحدة حتى لو تم استخدامه من قبل عدة اعتماديات).

## الاعتماديات ذات المعاملات (قائمة على الفئات)

```python
class RateLimiter:
    def __init__(self, calls: int):        # configure the dependency
        self.calls = calls
    def __call__(self, request: Request):  # callable → acts as a dependency
        check_rate_limit(request, self.calls)

@app.get("/items", dependencies=[Depends(RateLimiter(calls=100))])  # configured per route
def items(): ...
```

الفئة التي تحتوي على `__call__` هي اعتماد **قابل للتكوين** — تقوم بتمريرة المعاملات في وقت الاستخدام (مثل حدود معدلات مختلفة لكل مسار).

## الاعتماديات كتأثيرات جانبية (لا حاجة للإرجاع)

```python
@app.get("/admin", dependencies=[Depends(verify_admin)])   # run for the effect (auth check)
def admin(): ...                                            # don't need its return value
```

## الاعتماديات العامة وعلى مستوى الموجه

```python
app = FastAPI(dependencies=[Depends(verify_api_key)])      # applies to EVERY route
router = APIRouter(dependencies=[Depends(get_current_user)])  # to all routes in a router
```

طبّق الاعتماديات على مستوى التطبيق بالكامل أو لكل موجه للمتطلبات الشاملة (المصادقة، تحديد المعدل).

## التجاوزات للاختبار

```python
app.dependency_overrides[get_db] = get_test_db    # swap any dependency in tests
```

## لماذا يهمك

حقن الاعتماديات في FastAPI هو أحد أقوى ميزاته، وهذه الأنماط المتقدمة هي ما يتيح لك هيكلة التطبيقات الحقيقية والمعقدة بأناقة.

فهمها معرفة قيمة على مستوى أعلى: **الاعتماديات الفرعية** تبني طبقات قابلة لإعادة الاستخدام (token → user → admin) مع الحل التلقائي والتخزين المؤقت لكل طلب (تجنب العمل الزائد)؛ **الاعتماديات ذات المعاملات/القائمة على الفئات** تنشئ مكونات قابلة للتكوين وقابلة لإعادة الاستخدام (مقيدات المعدل، فحوصات الأذونات بإعدادات مختلفة لكل مسار)؛ **الاعتماديات كتأثيرات جانبية** تفرض المتطلبات بشكل نظيف (المصادقة) دون تعقيد التوقيعات؛ و**الاعتماديات العامة/على مستوى الموجه** تطبق الاهتمامات الشاملة (المصادقة، تحديد المعدل) على مجموعات كاملة من المسارات في مكان واحد.

بشكل حاسم، **تجاوز الاعتماديات** يجعل حتى أشجار الاعتماديات المعقدة قابلة للاختبار بسهولة.

إتقان هذه الأنماط — تكوين الاعتماديات، تمريرة معاملاتها، تحديد نطاقها عالمياً أو لكل موجه، وتجاوزها في الاختبارات — هو ما يتيح العمارة النظيفة والخالية من التكرار والقابلة للاختبار في تطبيقات FastAPI غير الضيقة، مما يميز المطورين الذين يمكنهم الاستفادة الكاملة من نظام DI في الإطار عن أولئك الذين يستخدمون فقط `Depends` الأساسي.

إنه موضوع مهم لبناء تطبيقات FastAPI منظمة وقابلة للصيانة وكبيرة الحجم.