Ποια προηγμένα dependency patterns υποστηρίζει το FastAPI;

Question

Accepted Answer

Πέρα από το βασικό `Depends`, το dependency injection του FastAPI υποστηρίζει προηγμένα patterns: **sub-dependencies**, **dependencies με παραμέτρους** (class-based ή μέσω factories), **scoped resources** (yield), **global/router dependencies**, και **dependency overrides** για testing — κάνοντάς το ένα ευέλικτο εργαλείο για τη δόμηση πραγματικών εφαρμογών.

## Sub-dependencies (dependency trees)

```python
def get_token(authorization: str = Header()):
    return parse(authorization)

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

def get_admin(user: User = Depends(get_current_user)):    # depends on that, in turn
    if not user.is_admin: raise HTTPException(403)
    return user
# FastAPI resolves the whole chain, caching shared dependencies within a request
```

Οι dependencies μπορούν να εξαρτώνται από άλλες dependencies, σχηματίζοντας ένα δέντρο που το FastAPI επιλύει αυτόματα (και **κρατάει στη cache** τις κοινές ανά request, έτσι το `get_token` τρέχει μόνο μία φορά ακόμα και αν χρησιμοποιείται από πολλές dependencies).

## Parameterized (class-based) dependencies

```python
class RateLimiter:
    def __init__(self, calls: int):        # configure the dependency
        self.calls = calls
    def __call__(self, request: Request):  # callable → acts as a dependency
        check_rate_limit(request, self.calls)

@app.get("/items", dependencies=[Depends(RateLimiter(calls=100))])  # configured per route
def items(): ...
```

Μια κλάση με `__call__` είναι μια **configurable** dependency — την παραμετροποιείς κατά την ώρα χρήσης (π.χ. διαφορετικά rate limits ανά route).

## Dependencies ως side-effects (δεν απαιτείται return)

```python
@app.get("/admin", dependencies=[Depends(verify_admin)])   # run for the effect (auth check)
def admin(): ...                                            # don't need its return value
```

## Global και router-level dependencies

```python
app = FastAPI(dependencies=[Depends(verify_api_key)])      # applies to EVERY route
router = APIRouter(dependencies=[Depends(get_current_user)])  # to all routes in a router
```

Εφάρμοσε dependencies σε ολόκληρη την εφαρμογή ή ανά router για cross-cutting requirements (auth, rate limiting).

## Overrides για testing

```python
app.dependency_overrides[get_db] = get_test_db    # swap any dependency in tests
```

## Γιατί έχει σημασία

Το dependency injection του FastAPI είναι ένα από τα πιο ισχυρά χαρακτηριστικά του, και αυτά τα προηγμένα patterns είναι αυτά που σε αφήνουν να δομήσεις πραγματικές, περίπλοκες εφαρμογές κομψά.

Το να τα καταλαβαίνεις είναι πολύτιμη γνώση senior-level: **sub-dependencies** δημιουργούν επαναχρησιμοποιήσιμα layers (token → user → admin) με αυτόματη επίλυση και per-request caching (αποφεύγοντας περιττό έργο); **parameterized/class-based dependencies** δημιουργούν ρυθμιζόμενα, επαναχρησιμοποιήσιμα components (rate limiters, permission checks με διαφορετικές ρυθμίσεις ανά route); **dependencies ως side-effects** εφαρμόζουν κομψά απαιτήσεις (auth) χωρίς να μολύνουν τις υπογραφές συναρτήσεων· και **global/router-level dependencies** εφαρμόζουν cross-cutting concerns (authentication, rate limiting) σε ολόκληρες ομάδες routes σε ένα μόνο μέρος.

Σημαντικό είναι ότι **dependency overrides** κάνουν ακόμα και περίπλοκα dependency graphs τετριμμένα testable.

Το να κατακτήσεις αυτά τα patterns — σύνθεση dependencies, παραμετροποίησή τους, scope τους globally ή per-router, και override τους στα tests — είναι αυτό που επιτρέπει καθαρή, DRY, testable αρχιτεκτονική σε μη-τετριμμένες FastAPI εφαρμογές, διακρίνοντας developers που μπορούν να αξιοποιήσουν πλήρως το DI system του framework από αυτούς που χρησιμοποιούν μόνο το βασικό `Depends`.

Είναι ένα σημαντικό θέμα για τη δημιουργία καλά-δομημένων, συντηρήσιμων, large-scale FastAPI εφαρμογών.