আপনার এন্ডপয়েন্টগুলির জন্য কখন `async def` ব্যবহার করবেন এবং কখন নিয়মিত `def` ব্যবহার করবেন?

Question

Accepted Answer

FastAPI `async def` এবং নিয়মিত `def` উভয়ই পাথ অপারেশনের জন্য সমর্থন করে। এই পছন্দটি পারফরম্যান্সের জন্য গুরুত্বপূর্ণ: যখন আপনি নন-ব্লকিং I/O `await` করতে পারেন তখন **`async def`** ব্যবহার করুন, এবং যখন আপনার কোড ব্লকিং (সিঙ্ক্রোনাস) অপারেশন কল করে তখন নিয়মিত **`def`** ব্যবহার করুন।

## দুটি ফর্ম

```python
@app.get("/async")
async def async_endpoint():
    data = await fetch_from_api()        # await non-blocking I/O — efficient
    return data

@app.get("/sync")
def sync_endpoint():
    data = blocking_db_call()             # ordinary blocking code
    return data
```

## FastAPI কীভাবে প্রতিটি হ্যান্ডেল করে

```text
async def → runs on the main event loop. Efficient ONLY if you await non-blocking calls.
            ⚠️ A BLOCKING call inside async def blocks the WHOLE event loop → kills concurrency!
def       → FastAPI runs it in a THREAD POOL, so blocking code doesn't block the event loop.
            Safe for synchronous/blocking libraries.
```

## সিদ্ধান্তের নিয়ম

```python
# ✅ async def — when you can await async libraries (httpx, async DB drivers)
async def get_user():
    async with httpx.AsyncClient() as c:
        return await c.get(url)

# ✅ plain def — when using SYNCHRONOUS/blocking libraries (requests, sync ORM)
def get_user():
    return requests.get(url).json()       # blocking → FastAPI runs it in a thread

# ❌ THE DANGEROUS MISTAKE — blocking call inside async def
async def bad():
    return requests.get(url).json()       # blocks the event loop! Use `def` or an async client
```

সমালোচনামূলক নিয়ম: **কখনও `async def` এ ব্লকিং কল রাখবেন না** — এটি ইভেন্ট লুপকে ব্লক করে এবং কনকারেন্সি ধ্বংস করে। হয় `await` সহ একটি async লাইব্রেরি ব্যবহার করুন, অথবা একটি সাধারণ `def` ব্যবহার করুন (যা FastAPI নিরাপদে একটি থ্রেড পুলে চালায়)।

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

`async def` এবং `def` এর মধ্যে সঠিক পছন্দ আপনার API-র পারফরম্যান্স এবং কনকারেন্সি সরাসরি প্রভাবিত করে, এবং এটি ভুল করা একটি সাধারণ, গুরুতর ভুল।

মূল অন্তর্দৃষ্টি হল যে **`async def` শুধুমাত্র তখনই উপকারী যখন আপনি নন-ব্লকিং অপারেশন `await` করেন** — একটি ব্লকিং কল (যেমন সিঙ্ক্রোনাস `requests` লাইব্রেরি বা একটি ব্লকিং ডাটাবেস ড্রাইভার) একটি `async def` এর মধ্যে রাখলে সম্পূর্ণ ইভেন্ট লুপ ব্লক করে, সমস্ত কনকারেন্ট রিকোয়েস্ট ফ্রিজ করে এবং async এর উদ্দেশ্য নষ্ট করে।

বিপরীতভাবে, FastAPI চতুরভাবে সাধারণ `def` এন্ডপয়েন্টগুলি একটি থ্রেড পুলে চালায়, তাই সিঙ্ক্রোনাস/ব্লকিং কোড সেখানে নিরাপদ।

এই নিয়মটি বোঝা — `async def` ব্যবহার করুন সত্যিকারের async লাইব্রেরির সাথে, সাধারণ `def` ব্যবহার করুন ব্লকিং কোডের জন্য, এবং কখনও ব্লকিং কল `async def` এর মধ্যে মিশ্রিত করবেন না — কর্মক্ষম FastAPI এন্ডপয়েন্ট লেখার জন্য অপরিহার্য এবং সূক্ষ্ম কিন্তু বিধ্বংসী ভুলটি এড়ানোর জন্য যেখানে আপনি অনিচ্ছাকৃতভাবে একটি ব্লক করা ইভেন্ট লুপের পিছনে সমস্ত রিকোয়েস্ট সিরিয়ালাইজ করেন।