آپ کو endpoints کے لیے async def بمقابلہ def کب استعمال کرنا چاہیے؟

Question

Accepted Answer

FastAPI `async def` اور عام `def` دونوں کو path operations کے لیے سپورٹ کرتا ہے۔ یہ انتخاب کارکردگی کے لیے اہم ہے: **`async def`** استعمال کریں جب آپ non-blocking I/O کو `await` کر سکتے ہوں، اور عام **`def`** استعمال کریں جب آپ کا کوڈ blocking (synchronous) operations کو کال کرتا ہے۔

## دونوں شکلیں

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

نازک اصول: **کبھی blocking calls کو `async def` میں نہ رکھیں** — یہ event loop کو بند کردیتا ہے اور concurrency کو تباہ کرتا ہے۔ یا تو `await` کے ساتھ async library استعمال کریں، یا سادہ `def` استعمال کریں (جسے FastAPI محفوظ طریقے سے thread pool میں چلاتا ہے)۔

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

`async def` اور `def` کے درمیان صحیح انتخاب سیدھا آپ کے API کی کارکردگی اور concurrency کو متاثر کرتا ہے، اور غلط انتخاب کرنا ایک عام، سنگین غلطی ہے۔

اہم بات یہ ہے کہ **`async def` صرف اس وقت فائدہ مند ہے جب آپ non-blocking operations کو `await` کریں** — ایک blocking call (جیسے synchronous `requests` library یا blocking database driver) کو `async def` کے اندر رکھنا پورے event loop کو روک دیتا ہے، تمام concurrent requests کو منجمد کرتا ہے اور async کے مقصد کو ختم کرتا ہے۔

برعکس، FastAPI سادہ `def` endpoints کو thread pool میں چلاتا ہے، تو synchronous/blocking code وہاں محفوظ ہے۔

اس اصول کو سمجھنا — `async def` کو واقعی async libraries کے ساتھ استعمال کریں، سادہ `def` کو blocking code کے لیے استعمال کریں، اور کبھی blocking calls کو `async def` میں نہ ملائیں — performant FastAPI endpoints لکھنے اور ایک ظریف لیکن تباہ کن غلطی سے بچنے کے لیے ضروری ہے جو تمام requests کو blocked event loop کے پیچھے serialize کرتا ہے۔