Be pagrindinės Depends, FastAPI priklausomybių injekcija palaiko išplėstus šablonus: sub-priklausomybės, priklausomybės su parametrais (klasės pagrindas arba per fabrikus), aprašytų ištekliai (yield), ir bandymams — tai daro ją universaliu įrankiu tikrų aplikacijų struktūrizavimui.
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
Priklausomybės gali priklausyti nuo kitų priklausomybių, suformuodamos medį, kurį FastAPI automatiškai išsprendžia (ir teikia iš cache bendras per užklausą, todėl get_token vykdoma vieną kartą, net jei naudojama kelių priklausomybių).
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(): ...
Klasė su __call__ yra konfigūruojama priklausomybė — parametrizuojate ją naudojimo metu (pvz., skirtingos šio limito per maršrutą).
@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
Taikykite priklausomybes visoje aplikacijoje arba per maršrutizatorių dėl skersai besitęsiančių reikalavimų (autentifikacija, šio limitavimas).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
FastAPI priklausomybių injekcija yra viena iš jos galingiausių funkcijų, ir šie išplėsti šablonai yra tai, kas leidžia elegantiškose tikrų, sudėtingų aplikacijų struktūrą.
Jų supratimas yra vertingas aukšto lygio žinios: sub-priklausomybės sukuria pakartotinai naudojamus sluoksnius (žeton → vartotojas → administratorius) su automatine rezoliucija ir keliamoji iš cache per užklausą (vengiant nereikalingo darbo); parametrizuotos/klasės pagrindas priklausomybės kuria konfigūruojamus, pakartotinai naudojamus komponentus (šio limitatorius, leidimų patikrą su skirtingomis nustatymais per maršrutą); priklausomybės kaip šalutiniai efektai švieži įgyvendina reikalavimus (autentifikacija) be funkcijų parašų sumaišymo; ir globalinės/maršrutizatoriaus lygio priklausomybės taiko skersai besitęsiančias sąmatą (autentifikacija, šio limitavimas) visoms maršrutų grupėms vienu metu.
Krucialiai, priklausomybių perrašymai daro net sudėtingus priklausomybių grafikūs trivialiai bandytinus.
Mokėti šiuos šablonus — sukomponuoti priklausomybes, parametrizuoti jas, aprašyti jas globaliai arba per maršrutizatorių ir perrašyti jas bandymuose — tai įgalina šviesę, DRY, bandytina architektūrą ne trivialūse FastAPI aplikacijose, išskiriant kūrėjus, kurie gali visapusiškai pasinaudoti sistemos DI sistema iš tų, kurie naudoja tik pagrindinę Depends.
Tai svarbi tema kuriant gerai struktūrizuotas, prižiūrimas, didelės apimties FastAPI aplikacijas.