Si funksionojnë BackgroundTasks?

Question

Accepted Answer

**`BackgroundTasks`** e FastAPI-t ju lejon të ekzekutoni punë **pas kthimit të përgjigjes** — kështu që klienti merr një përgjigje të shpejtë ndërsa puna e lehtë në vazhdim (dërgim email-i, regjistring, pastrrim) bëhet në sfond. Është i ndërtuar në dhe i thjeshtë, për detyra të lehta.

## Përdorimi i 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
```

Shtoni një parametër `BackgroundTasks` dhe thirrni `add_task(func, *args)`. FastAPI dërgon përgjigjen fillimisht, pastaj ekzekuton detyrat në radhë — kështu që përdoruesi nuk pret për email-in.

## Detyra të shumëfishta dhe përdorim me varësira

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

## Kufizimi vendimtar: nuk është për punë të rëndë/kritike

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

## Kur të përdorni cilën

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

## Pse është e rëndësishme

`BackgroundTasks` është një mjet i përshtatshëm i ndërtuar për nevojën e zakonshme të bërjes së punës në vazhdim pa e mbajtur klientin në pritje — dërgim email-i mirëseardhëse, shkrimi i ditarit, pastrrim i lehtë — përmirësimi i kohëve të përgjigjes për përdoruesin.

Në kuptim atë është e dobishme për këto raste të zakonshme të lehta pasi nuk kërkon infrastrukturë shtesë.

Megjithatë **pika më e rëndësishme** është njohja e **kufizimeve të tij**: sepse funksionon në të njëjtin proces si shërbyesi web, nuk ofron përqëndrueshmëri (detyrat humben në rënie/ripërtëritje), asnjë përpjekje të re, asnjë planifikimi, dhe nuk është i përshtatshëm për punë të rëndë ose kritike.

Përkufizimi i kësaj kufiri — përdorimi i `BackgroundTasks` për detyra të shpejta, jo-kritike, "zjarr-dhe-harrë", dhe një rend të vërtetë punësh si **Celery/ARQ** për punë të përhershme, të riprovojsh, të planifikuara ose të rënda — është gjykimi kryesor që parandalon gabimin e zakonshëm të mbështetjes në BackgroundTasks për punë që nuk duhet të humbet, duke e bërë këtë njohuri të rëndësishme praktike për ndërtimin e aplikacioneve të besueshme.