Si funksionon injektimi i varësive (Depends)?

Question

Accepted Answer

Sistemi i **injektimit të varësive** të FastAPI-t ju lejon të deklaroni varësi të ripërdorshme (funksione/klasa) që FastAPI thërret dhe **injekton** në operacionet tuaja të rrugës përmes `Depends()`. Përdoret për logjikë të ndarë si seanca bazash të dhënash, autentifikimi, dhe parametrat e zakonshëm — duke mbajtur kodin DRY dhe të testueshem.

## Një varësi bazike

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

Deklarimi i `params = Depends(pagination)` i thotë FastAPI-t të thërrasë `pagination` (duke zgjidhur *parametrat e tij* nga kërkesa gjithashtu) dhe të kalojë rezultatin në funksionin tuaj. Varësia është e ripërdorshme në shumë endpoint-e.

## Varësitë me pastrimin (yield) — p.sh. seanca bazash të dhënash

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

Një varësi `yield` jep një burim dhe ekzekuton pastrimin pas kërkesës — modeli standard për seanca bazash të dhënash (hape përpara, mbyll pas, automatikisht).

## Varësitë mund të varen nga varësitë

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

Varësitë formojnë një pemë — FastAPI zgjidh të gjithë zinxhirin. Kështu bëhet zakonisht autentifikimi (një varësi `get_current_user`).

## Varësitë e klasave dhe ripërdorimi

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

## Pse ka rëndësi

Injektimi i varësive është një nga veçoritë më të fuqishme dhe më të rëndësishme të FastAPI-t — kjo është mënyra se si ndani dhe ripërdorni logjikën në mënyrë të pastër në të gjithë endpoint-et (seanca bazash të dhënash, autentifikimi, parametrat e zakonshëm të pyetjeve, kontrollat e lejeve) pa përsëritje.

Kuptimi i tij është thelbësor sepse ai mbështet modelet bazike: **varësia `yield`** është mënyra standarde për të menaxhuar seanca bazash të dhënash (me pastrimin e garantuar pas çdo kërkese), dhe **varësia `get_current_user`** është mënyra idiomatike për të zbatuar autentifikimin.

DI gjithashtu e bën kodin shumë **të testueshem** — mund të zëvendësoni varësitë me qesmet në teste.

Eleganca e sistemit (varësitë zgjidhin parametrat e tyre nga kërkesa, mund të varen nga varësi të tjera duke formuar një pemë, dhe integrohen me dokumentet) e bën atë një mjet të gjithanshëm për strukturimin e aplikacioneve reale, kështu që përmbushja i `Depends` është kyçe për ndërtimin e aplikacioneve FastAPI të mirëorganizuara, të mirëmbajtshme dhe të tëstueshmë.