Kif taħdem l-injezzjoni tal-dipendenza (Depends)?

Question

Accepted Answer

Is-sistema ta' **injezzjoni tal-dipendenza** ta' FastAPI tippermettik tiddikjara dipendenzi li jistgħu jintużaw mill-ġdid (funzjonijiet/klassijiet) li FastAPI jsejjaħ u **jinjettak** fl-operazzjonijiet tal-mogħdija tiegħek permezz ta' `Depends()`. Tintuża għal-loġika maqsuma bħal-sessjonijiet tad-database, l-awtentifikazzjoni, u l-parametri komuni — iżomm il-kodiċi DRY u testabbli.

## Dipendenza bażika

```python
from fastapi import Depends

# a dependency is just a callable that returns something
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI calls pagination() and injects the result
    return params
# the skip/limit query params are now handled by the reusable dependency
```

Tiddikjara `params = Depends(pagination)` tgħid lil FastAPI biex isejjaħ `pagination` (tissolvi l-*parametri* tagħha mir-rikilesta wkoll) u tgħaddi r-riżultat fil-funzjoni tiegħek. Id-dipendenza tista' titnieda mill-ġdid fuq ħafna endpoints.

## Dipendenza b'naddaf (yield) — pereż. sessjonijiet tad-database

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # provide the session to the endpoint
    finally:
        db.close()                # cleanup runs AFTER the response — guaranteed

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # uses the injected, auto-closed session
```

Dipendenza ta' `yield` tipprovdi risorsa u taħdem il-maħrij wara r-rikilesta — il-mudell standard għas-sessjonijiet tad-database (iftaħ qabel, agħlaq wara, awtomatikament).

## Id-dipendenza tista' tiddependi fuq id-dipendenza

```python
def get_current_user(token: str = Depends(get_token)):   # depends on another dependency
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth via injection
    return user
```

Id-dipendenza tifforma siġra — FastAPI tissolvi l-katina kollha. Dan huwa kif l-awtentifikazzjoni ġenwement isir (dipendenza ta' `get_current_user`).

## Dipendenza tal-klassь u r-riużu

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # run a dependency without using its return
def items(): ...                                              # e.g. enforce auth as a side effect
```

## Għaliex dan importante

L-injezzjoni tal-dipendenza hija waħda mill-aktar karatteristiċi qawwija u importanti ta' FastAPI — din hi d-dħul kif taqsam u tirriżvulta l-loġika b'mod neċ fuq l-endpoints (sessjonijiet tad-database, awtentifikazzjoni, parametri ta' mistoqsija komuni, kontrolli ta' permess) mingħajr duplikazzjoni.

L-iftehim tiegħu huwa essenzjali għaliex huwa l-bazi tal-mudelli ewlenin: **dipendenza ta' `yield`** hija l-mod standard biex tudir sessjonijiet tad-database (b'naddaf garantit wara kull rikesta), u **dipendenza ta' `get_current_user`** hija l-mod idiomatiku biex timplimenta l-awtentifikazzjoni.

DI wkoll tagħmel il-kodiċi **testabbli** ħafna — tista' tordna l-dipendenza b'mock fit-testir.

L-eleganża tas-sistema (id-dipendenza tissolvi l-parametri tagħha stess mir-rikilesta, tista' tiddependi fuq dipendenza oħra li tifforma siġra, u integrata mad-dokumentazzjoni) tigħaliha aħjar għad-duttrina l-applikazzjonijiet reali, għalhekk li titgħallem `Depends` hija l-muftaħ għad-bini ta' applikazzjonijiet ta' FastAPI morganizzati tajjeb, mantinut, u testabbli.