BackgroundTasks کیسے کام کرتے ہیں؟

Question

Accepted Answer

FastAPI کی **`BackgroundTasks`** آپ کو **جواب واپس کرنے کے بعد** کام چلانے کی اجازت دیتی ہے — تاکہ کلائنٹ کو تیز جواب ملے جبکہ ہلکے فالو اپ کام (ای میل بھیجنا، logging، صفائی) پس منظر میں ہوں۔ یہ built-in ہے اور سادہ ہے، lightweight tasks کے لیے۔

## BackgroundTasks کا استعمال

```python
from fastapi import BackgroundTasks

def send_email(address: str, message: str):
    # slow-ish work that the client shouldn't wait for
    email_client.send(address, message)

@app.post("/signup")
def signup(user: User, background_tasks: BackgroundTasks):   # inject BackgroundTasks
    save_user(user)
    background_tasks.add_task(send_email, user.email, "Welcome!")   # queue it
    return {"message": "User created"}    # RESPONSE returns NOW; email sends AFTER
```

`BackgroundTasks` parameter inject کریں اور `add_task(func, *args)` کو کال کریں۔ FastAPI پہلے جواب بھیجتا ہے، پھر queued task(s) کو چلاتا ہے — تاکہ صارف ای میل کے لیے انتظار نہ کرے۔

## متعدد tasks اور dependencies کے ساتھ استعمال

```python
@app.post("/order")
def create_order(order: Order, bg: BackgroundTasks):
    bg.add_task(send_confirmation, order.email)
    bg.add_task(update_analytics, order.id)     # multiple tasks run in order, after the response
    return {"status": "created"}
```

## اہم حد بندی: یہ heavy/critical کام کے لیے نہیں ہے

```text
BackgroundTasks runs IN THE SAME PROCESS as the web server:
  ✗ NO persistence — if the server crashes/restarts, queued tasks are LOST
  ✗ NO retries, scheduling, or distribution
  ✗ Heavy CPU work would still tie up the worker process
→ Good for: quick, non-critical, fire-and-forget tasks (emails, logging, light cleanup)
→ For heavy, critical, retryable, or scheduled jobs → use Celery / ARQ (a real task queue)
```

## کب کیا استعمال کریں

```text
BackgroundTasks → simple, lightweight, best-effort work tied to a request (no extra infra)
Celery / ARQ    → durable, retryable, scheduled, distributed jobs (needs a broker/workers)
```

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

`BackgroundTasks` ایک سہل built-in ٹول ہے فالو اپ کام کرنے کی عام ضرورت کے لیے بغیر کلائنٹ کو انتظار میں رکھے — خوش آمدید ای میل بھیجنا، log لکھنا، ہلکی صفائی — صارف کے لیے response times بہتر بناتے ہوئے۔
	nیہ سمجھنا ان روز مرہ lightweight cases کے لیے مفید ہے کیونکہ اس میں کوئی extra infrastructure کی ضرورت نہیں۔

لیکن **سب سے اہم نکتہ** اس کی **حد بندیوں** کو جاننا ہے: کیونکہ یہ web server کے ساتھ ایک ہی process میں چلتا ہے، یہ کوئی persistence نہیں دیتا (tasks crash/restart پر ضائع ہو جاتے ہیں)، کوئی retries نہیں، scheduling نہیں، اور heavy یا critical کام کے لیے موزوں نہیں۔

اس حد کو پہچاننا — `BackgroundTasks` کو تیز، غیر اہم، fire-and-forget tasks کے لیے استعمال کرنا، اور ایک حقیقی task queue جیسے **Celery/ARQ** کو durable، retryable، scheduled، یا heavy background jobs کے لیے استعمال کرنا — یہ اہم فیصلہ ہے جو `BackgroundTasks` پر انحصار کرنے کی عام غلطی سے بچاتا ہے ایسے کام کے لیے جو ضائع نہیں ہونا چاہیے، یہ قابل اعتماد applications بنانے کے لیے اہم عملی علم ہے۔