Dependency Injection (Depends) کیسے کام کرتا ہے؟

Question

Accepted Answer

FastAPI کا **dependency injection** نظام آپ کو دوبارہ استعمال کے قابل dependencies (functions/classes) کا اعلان کرنے دیتا ہے جو FastAPI کال کرتا ہے اور `Depends()` کے ذریعے آپ کے path operations میں **inject** کرتا ہے۔ یہ مشترکہ منطق جیسے database sessions، authentication، اور عام parameters کے لیے استعمال ہوتا ہے — کوڈ کو DRY اور testable رکھتا ہے۔

## ایک بنیادی dependency

```python
from fastapi import Depends

# a dependency is just a callable that returns something
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI calls pagination() and injects the result
    return params
# the skip/limit query params are now handled by the reusable dependency
```

`params = Depends(pagination)` کا اعلان FastAPI کو بتاتا ہے کہ `pagination` کو کال کریں (اس کے parameters کو درخواست سے resolve کرتے ہوئے) اور نتیجہ کو آپ کے فنکشن میں ڈالیں۔ dependency بہت سے endpoints میں دوبارہ استعمال کے قابل ہے۔

## صفائی کے ساتھ dependencies (yield) — مثال کے طور پر database sessions

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # provide the session to the endpoint
    finally:
        db.close()                # cleanup runs AFTER the response — guaranteed

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # uses the injected, auto-closed session
```

ایک `yield` dependency ایک وسیلہ فراہم کرتا ہے اور درخواست کے بعد teardown چلاتا ہے — database sessions کے لیے معیاری نمونہ (پہلے کھولیں، بعد میں بند کریں، خودکار طور پر)۔

## Dependencies دوسری dependencies پر منحصر ہو سکتے ہیں

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

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth via injection
    return user
```

Dependencies ایک درخت بناتے ہیں — FastAPI پورے chain کو حل کرتا ہے۔ یہ ہے کہ authentication عام طور پر کیسے کیا جاتا ہے (`get_current_user` dependency)۔

## Class dependencies اور دوبارہ استعمال

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # run a dependency without using its return
def items(): ...                                              # e.g. enforce auth as a side effect
```

## یہ کیوں اہم ہے

Dependency injection FastAPI کی سب سے طاقتور اور اہم خصوصیات میں سے ایک ہے — یہ ہے کہ آپ منطق کو صاف ستھرے طریقے سے endpoints میں شیئر اور دوبارہ استعمال کریں (database sessions، authentication، مشترکہ query parameters، permission checks) بغیر نقل کے۔

اس کو سمجھنا ضروری ہے کیونکہ یہ بنیادی نمونوں کی بنیاد ہے: **`yield` dependency** database sessions کو منظم کرنے کا معیاری طریقہ ہے (ہر درخواست کے بعد ضمانتی صفائی کے ساتھ)، اور **`get_current_user` dependency** authentication کو نافذ کرنے کا اصولی طریقہ ہے۔

DI کوڈ کو انتہائی **testable** بھی بناتا ہے — آپ tests میں mocks کے ساتھ dependencies کو override کر سکتے ہیں۔

نظام کی خوبصورتی (dependencies اپنے parameters کو درخواست سے حل کرتے ہیں، دوسری dependencies پر منحصر ہو سکتے ہیں ایک درخت بناتے ہوئے، اور docs کے ساتھ integrate ہوتے ہیں) اسے حقیقی ایپلیکیشنز کو منظم کرنے کے لیے ایک ورسیٹائل ٹول بناتا ہے، لہذا `Depends` میں مہارت حاصل کرنا اچھی طرح سے منظم، دیکھ بھال کے قابل، testable FastAPI ایپلیکیشنز بنانے کے لیے اہم ہے۔