Selain Depends dasar, injeksi dependensi FastAPI mendukung pola-pola advanced: sub-dependencies, dependencies dengan parameter (berbasis class atau melalui factories), scoped resources (yield), global/router dependencies, dan untuk testing — menjadikannya alat yang serbaguna untuk menstruktur aplikasi nyata.
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 dapat bergantung pada dependencies lain, membentuk pohon yang FastAPI selesaikan secara otomatis (dan cache yang shared per request, jadi get_token berjalan sekali meskipun digunakan oleh beberapa dependencies).
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(): ...
Sebuah class dengan __call__ adalah dependency yang configurable — Anda parameterisasi pada saat penggunaan (mis. rate limits berbeda per route).
@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
Terapkan dependencies di seluruh app atau per-router untuk kebutuhan cross-cutting (auth, rate limiting).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
Injeksi dependensi FastAPI adalah salah satu fitur paling powerful-nya, dan pola-pola advanced ini adalah yang memungkinkan Anda menstruktur aplikasi real dan kompleks dengan elegan.
Memahaminya adalah pengetahuan tingkat senior yang berharga: sub-dependencies membangun layer yang reusable (token → user → admin) dengan resolusi otomatis dan per-request caching (menghindari pekerjaan redundan); parameterized/class-based dependencies menciptakan komponen yang configurable dan reusable (rate limiters, permission checks dengan setting berbeda per route); dependencies sebagai side-effects secara clean menegakkan requirement (auth) tanpa mengacaukan function signatures; dan global/router-level dependencies menerapkan cross-cutting concerns (authentication, rate limiting) ke seluruh kelompok routes di satu tempat.
Crucially, dependency overrides membuat dependency graphs yang kompleks sekalipun trivially testable.
Menguasai pola-pola ini — composing dependencies, parameterisasi mereka, scoping mereka globally atau per-router, dan override mereka di tests — adalah yang memungkinkan clean, DRY, testable architecture dalam aplikasi FastAPI non-trivial, membedakan developers yang dapat leverage sistem DI framework secara penuh dari mereka yang hanya menggunakan Depends dasar.
Ini adalah topik penting untuk membangun well-structured, maintainable, large-scale FastAPI apps.