Какие продвинутые паттерны зависимостей поддерживает FastAPI?

Question

Accepted Answer

Помимо базового `Depends`, система внедрения зависимостей FastAPI поддерживает продвинутые паттерны: **под-зависимости**, **зависимости с параметрами** (на основе классов или через фабрики), **ресурсы с областью видимости** (yield), **глобальные/маршрутные зависимости** и **переопределение зависимостей** для тестирования — что делает её универсальным инструментом для структурирования реальных приложений.

## Под-зависимости (деревья зависимостей)

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

Зависимости могут зависеть от других зависимостей, образуя дерево, которое FastAPI разрешает автоматически (и **кеширует** общие на один запрос, так что `get_token` выполняется один раз даже если используется несколькими зависимостями).

## Параметризованные (на основе классов) зависимости

```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__` — это **конфигурируемая** зависимость — вы параметризуете её во время использования (например, разные лимиты на разных маршрутах).

## Зависимости как побочные эффекты (возвращаемое значение не требуется)

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

## Глобальные и маршрутные зависимости

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

Применяйте зависимости на уровне приложения или отдельного маршрутизатора для сквозных требований (аутентификация, ограничение частоты).

## Переопределение для тестирования

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

## Почему это важно

Система внедрения зависимостей FastAPI — одна из её самых мощных функций, и эти продвинутые паттерны позволяют элегантно структурировать реальные, сложные приложения.

Понимание их — ценное знание уровня senior: **под-зависимости** строят переиспользуемые слои (токен → пользователь → администратор) с автоматическим разрешением и кешированием на один запрос (избегая избыточной работы); **параметризованные/на основе классов зависимости** создают конфигурируемые, переиспользуемые компоненты (ограничители частоты, проверки разрешений с разными настройками на маршрут); **зависимости как побочные эффекты** чисто обеспечивают требования (аутентификация) без загромождения сигнатур функций; и **глобальные/маршрутные зависимости** применяют сквозные требования (аутентификация, ограничение частоты) к целым группам маршрутов в одном месте.

Критически важно, что **переопределение зависимостей** делает даже сложные графы зависимостей тривиально тестируемыми.

Овладение этими паттернами — компоновка зависимостей, их параметризация, применение их в глобальной области или на уровне маршрутизатора, и переопределение их в тестах — это то, что позволяет создавать чистую, DRY, тестируемую архитектуру в нетривиальных приложениях FastAPI, отличая разработчиков, которые полностью используют систему DI фреймворка, от тех, кто использует только базовый `Depends`.

Это важная тема для построения хорошо структурированных, поддерживаемых крупномасштабных приложений FastAPI.