BackgroundTasks कसरी काम गर्छ?

Question

Accepted Answer

FastAPI को **`BackgroundTasks`** ले तपाईलाई **response फर्काएपछि** काम गर्न सक्षम बनाउँछ — यसरी क्लाइन्टले द्रुत जवाफ पाएको बेलामा हल्का अनुगामी काम (इमेल पठाउनु, लॉगिङ, सफाई) पृष्ठभूमिमा हुन्छ। यो अन्तर्निहित र सरल छ, हल्का कार्यहरूको लागि।

## 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` प्यारामिटर इन्जेक्ट गर्नुहोस् र `add_task(func, *args)` कल गर्नुहोस्। FastAPI पहिले response पठाउँछ, त्यसपछि क्यु गरिएका कार्यहरू चलाउँछ — यसरी प्रयोगकर्ता इमेलको लागि प्रतीक्षा गर्दिनन्।

## बहुविध कार्यहरू र निर्भरताहरूसँग प्रयोग

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

## महत्वपूर्ण सीमितता: यो भारी/गुरुत्वपूर्ण कामको लागि छैन

```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` क्लाइन्टलाई प्रतीक्षा गर्न नदिई अनुगामी कामको साधारण आवश्यकताको लागि एक सुविधाजनक अन्तर्निहित उपकरण हो — स्वागत इमेल पठाउनु, लग लेख्नु, हल्का सफाई — प्रयोगकर्ताको लागि प्रतिक्रिया समय सुधार गर्दै।

यो बुझ्नु यी दैनिक हल्का केसहरूको लागि उपयोगी छ किनकि यसलाई कुनै अतिरिक्त अवसंरचना आवश्यक छैन।

तर **सबैभन्दा महत्वपूर्ण बिन्दु** यसको **सीमितताहरू** बुझ्नु हो: किनभने यो वेब सर्भरको समान प्रक्रियामा चल्छ, यो कुनै दृढता (कार्यहरू क्र्यास/पुनः सुरु गर्दा हराउँछन्), कोनै पुनः प्रयासहरू, कोनै समय निर्धारण, र भारी वा गुरुत्वपूर्ण कामको लागि उपयुक्त छैन।

यो सीमा पहिचान गर्नु — `BackgroundTasks` प्रयोग गर्नु द्रुत, गैर-गुरुत्वपूर्ण, आग-र-विस्मृत कार्यहरूको लागि, र वास्तविक कार्य क्यू जस्तै **Celery/ARQ** दुर्दान्त, पुनः प्रयासयोग्य, समय निर्धारित, वा भारी पृष्ठभूमि कार्यहरूको लागि — साधारण गल्तीलाई रोक्ने कुञ्जी हो BackgroundTasks मा निर्भर गर्नुको, यो विश्वसनीय अनुप्रयोगहरू निर्माण गर्नको लागि महत्वपूर्ण व्यावहारिक ज्ञान बनाउँछ।