Kromě základního Depends podporuje FastAPI Dependency Injection pokročilé vzory: pod-závislosti, závislosti s parametry (na bázi tříd nebo prostřednictvím továren), vymezené zdroje (yield), globální/routerové závislosti a pro testování — což z toho dělá všestranný nástroj pro strukturování skutečných aplikací.
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
Závislosti mohou záviset na jiných závislostech, což vytváří strom, který FastAPI automaticky řeší (a cachuje sdílené závislosti na požadavek, takže get_token se spustí jen jednou, i když je použito několika závislostmi).
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(): ...
Třída s __call__ je konfigurabilní závislost — parametrizujete ji v čase použití (např. různé limity sazeb na trasu).
@app.get("/admin", dependencies=[Depends(verify_admin)]) # run for the effect (auth check)
def admin(): ... # don't need its return value
app = FastAPI(dependencies=[Depends(verify_api_key)]) # applies to EVERY route
router = APIRouter(dependencies=[Depends(get_current_user)]) # to all routes in a router
Aplikujte závislosti na celou aplikaci nebo na jednotlivé routery pro crosscutting požadavky (autentizace, rate limiting).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
Dependency Injection v FastAPI je jednou z jeho nejsilnějších funkcí a právě tyto pokročilé vzory vám umožňují elegantně strukturovat skutečné, složité aplikace.
Chápání těchto vzorů je cenné znalosti na seniorské úrovni: pod-závislosti budují opakovaně použitelné vrstvy (token → uživatel → admin) s automatickým řešením a cachováním na požadavek (vyhýbáním se zbytečné práci); parametrizované/na bázi tříd závislosti vytvářejí konfigurabilní, opakovaně použitelné komponenty (limitátory sazeb, kontroly oprávnění s různými nastaveními na trasu); závislosti jako vedlejší efekty čistě vynucují požadavky (autentizace) bez zahlcení signatury funkce; a globální/routerové závislosti aplikují crosscutting obavy (autentizace, rate limiting) na celé skupiny tras najednou.
Klíčově, přepsání závislostí činí dokonce i složité grafy závislostí triviálně testovatelné.
Vládnutí těmito vzory — skládání závislostí, jejich parametrizace, jejich vymezení globálně nebo na router, a jejich přepsání v testech — je to, co umožňuje čistou, DRY, testovatelnou architekturu v netriviálních aplikacích FastAPI, což rozlišuje vývojáře, kteří mohou plně využít systém DI frameworku, od těch, kteří používají pouze základní Depends.
Jde o důležité téma pro budování dobře strukturovaných, udržovatelných, velkoplošných aplikací FastAPI.