নির্ভরতা ইনজেকশন (Depends) কীভাবে কাজ করে?

Question

Accepted Answer

FastAPI এর **নির্ভরতা ইনজেকশন** সিস্টেম আপনাকে পুনঃব্যবহারযোগ্য নির্ভরতা (ফাংশন/ক্লাস) ঘোষণা করতে দেয় যা FastAPI কল করে এবং `Depends()` এর মাধ্যমে আপনার পাথ অপারেশনে **ইনজেক্ট** করে। এটি শেয়ার করা লজিকের জন্য ব্যবহৃত হয় যেমন ডাটাবেস সেশন, প্রমাণীকরণ এবং সাধারণ প্যারামিটার — কোড ডিআরওয়াই এবং পরীক্ষাযোগ্য রাখে।

## একটি মৌলিক নির্ভরতা

```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` কল করতে বলে (অনুরোধ থেকে *এর* প্যারামিটার সমাধান করে) এবং ফলাফল আপনার ফাংশনে পাস করে। নির্ভরতা অনেক এন্ডপয়েন্ট জুড়ে পুনঃব্যবহারযোগ্য।

## ক্লিনআপ সহ নির্ভরতা (yield) — যেমন ডাটাবেস সেশন

```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` নির্ভরতা একটি রিসোর্স প্রদান করে এবং অনুরোধের পরে টিয়ারডাউন চালায় — ডাটাবেস সেশনের জন্য মান প্যাটার্ন (আগে খুলুন, পরে বন্ধ করুন, স্বয়ংক্রিয়ভাবে)।

## নির্ভরতা অন্যান্য নির্ভরতার উপর নির্ভর করতে পারে

```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
```

নির্ভরতা একটি গাছ তৈরি করে — FastAPI সম্পূর্ণ চেইন সমাধান করে। এটি সাধারণত কীভাবে প্রমাণীকরণ করা হয় (একটি `get_current_user` নির্ভরতা)।

## ক্লাস নির্ভরতা এবং পুনঃব্যবহার

```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
```

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

নির্ভরতা ইনজেকশন FastAPI এর সবচেয়ে শক্তিশালী এবং গুরুত্বপূর্ণ বৈশিষ্ট্যগুলির মধ্যে একটি — এটি কীভাবে আপনি এন্ডপয়েন্টগুলি জুড়ে লজিক পরিচ্ছন্নভাবে ভাগ এবং পুনঃব্যবহার করেন (ডাটাবেস সেশন, প্রমাণীকরণ, সাধারণ কোয়েরি প্যারামিটার, অনুমতি চেক) কোন সদৃশতা ছাড়াই।

এটি বোঝা অপরিহার্য কারণ এটি মূল প্যাটার্নগুলিকে সমর্থন করে: **`yield` নির্ভরতা** ডাটাবেস সেশন পরিচালনার মান উপায় (প্রতিটি অনুরোধের পরে গ্যারান্টিযুক্ত ক্লিনআপ সহ), এবং একটি **`get_current_user` নির্ভরতা** প্রমাণীকরণ বাস্তবায়নের আদিয়োমেটিক উপায়।

ডিআই কোডকেও অত্যন্ত **পরীক্ষাযোগ্য** করে তোলে — আপনি পরীক্ষায় মক সহ নির্ভরতা ওভাররাইড করতে পারেন।

সিস্টেমের কমনীয়তা (নির্ভরতা অনুরোধ থেকে তাদের নিজস্ব প্যারামিটার সমাধান করে, অন্যান্য নির্ভরতার উপর নির্ভর করতে পারে একটি গাছ গঠন করে এবং ডক্সের সাথে সংহত হয়) এটিকে বাস্তব অ্যাপ্লিকেশন কাঠামোর জন্য একটি বহুমুখী সরঞ্জাম করে তোলে, তাই `Depends` আয়ত্ত করা ভালভাবে সংগঠিত, রক্ষণাবেক্ষণযোগ্য, পরীক্ষাযোগ্য FastAPI অ্যাপ তৈরির চাবিকাঠি।