Poleg osnovnega Depends FastAPI-jeva injekcija odvisnosti podpira napredne vzorce: pod-odvisnosti, odvisnosti s parametri (na osnovi razredov ali prek tovarn), omejene vire (yield), globalne/usmerjevalne odvisnosti in za testiranje — kar jo naredi vsestranski orodje za strukturiranje pravi aplikacij.
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
Odvisnosti se lahko zanašajo na druge odvisnosti, tvorijo drevo, ki ga FastAPI samodejno razrešuje (in predpomneva skupne med zahtevkom, zato se get_token izvede enkrat, čeprav je uporabljena v več odvisnostih).
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(): ...
Razred z __call__ je nastavljiva odvisnost — jo parametrizirate v času uporabe (npr. različne omejitve hitrosti na poti).
@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
Primeni odvisnosti po celotni aplikaciji ali za usmerjevalnik za prečne zahteve (avtentikacija, omejitev hitrosti).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
FastAPI-jeva injekcija odvisnosti je ena njegovih najbolj zmogljivih značilnosti, ti napredni vzorci pa so tisto, kar vam omogoča strukturiranje resničnih, kompleksnih aplikacij elegantno.
Razumevanje jih je dragoceno znanje na višji ravni: pod-odvisnosti zgradijo ponovno uporabne plasti (žeton → uporabnik → administrator) s samodejnim reševanjem in predpomnjenjem po zahtevku (izogibanje odvečnemu delu); parametrizirane/razredne odvisnosti ustvarijo nastavljive, ponovno uporabne komponente (omejevalniki hitrosti, preverjanja dovoljenj z različnimi nastavitvami na pot); odvisnosti kot stranski učinki jasno uveljavijo zahteve (avtentikacija) brez motenja podpisov funkcij; in globalne/usmerjevalne odvisnosti uporabljajo prečne poslovne zahteve (avtentikacija, omejitev hitrosti) na celotne skupine poti na enem mestu.
Krucialnega pomena je, da preglasitve odvisnosti naredijo tudi kompleksna drevesa odvisnosti brez napora testljiva.
Ovladanje temi vzorci — sestavljanje odvisnosti, njihova parametrizacija, njihovo obsežno ali usmejevalno obravnavo in njihove preglasitve v testih — je tisto, kar omogoča čisto, DRY, testljivo arhitekturo v ne-trivialnih FastAPI aplikacijah, kar razlikuje razvijalce, ki lahko v celoti izkoristijo sistem DI ogrodja, od tistih, ki uporabljajo le osnovni Depends.
To je pomembna tema za gradnjo dobro strukturiranih, vzdrževanih, obsežnih FastAPI aplikacij.