Kako delujejo BackgroundTasks?

Question

Accepted Answer

FastAPI-jevo **`BackgroundTasks`** vam omogoča, da **po vrnitvi odziva** zaženete delo — tako da odjemalec dobi hiter odgovor, medtem ko se lažja spremljujoča delo (pošiljanje e-pošte, beleženje, čiščenje) izvaja v ozadju. Vključeno je in preprosto, za lahke naloge.

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

Vstavite parameter `BackgroundTasks` in pokličite `add_task(func, *args)`. FastAPI najprej pošlje odziv, nato pa zažene poredane naloge — zato uporabnik ne čaka na e-pošto.

## Več nalog in uporaba z odvisnostmi

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

## Ključna omejitev: NI primerno za težko/kritično delo

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

## Kdaj uporabiti kaj

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

## Zakaj je to importante

`BackgroundTasks` je priročno vgrajena orodja za pogosto potrebo po opravljanju spremljujočega dela brez, da bi čakali odjemalca — pošiljanje pozdravnega e-maila, pisanje dnevnika, lažko čiščenje — izboljšanje časov odziva za uporabnika.

Razumevanje je koristno za te vsakodnevne lahke primere, ker ne zahteva dodatne infrastrukture.

Ampak **najpomembnejša točka** je poznavanje njegovih **omejitev**: ker se izvaja v istem procesu kot spletni strežnik, nudi brez trajnosti (naloge se izgubijo ob padcu/ponovnem zagonu), brez ponovnih poskusov, brez razporeditve in ni primerno za težko ali kritično delo.

Prepoznavanje te meje — uporaba `BackgroundTasks` za hitre, nekritične, oddajne naloge in pravi red čakanja na nalogo kot **Celery/ARQ** za trajne, ponovno poskusljive, razporejene ali težke naslone — je ključna presoja, ki preprečuje pogosto napako, da se zanašamo na BackgroundTasks za delo, ki se ne sme izgubiti, kar je to pomembno praktično znanje za gradnjo zanesljivih aplikacij.