Temel Depends ötesinde, FastAPI'ın bağımlılık enjeksiyonu gelişmiş desenleri destekler: alt-bağımlılıklar, parametreli bağımlılıklar (sınıf tabanlı veya fabrika aracılığıyla), kapsamlı kaynaklar (yield), ve (test için) — bu da onu gerçek uygulamaları yapılandırmak için çok yönlü bir araç haline getiriyor.
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
Bağımlılıklar diğer bağımlılıklara bağlı olabilir ve FastAPI'ın otomatik olarak çözdüğü bir ağaç oluştururlar (ve paylaşılan olanları istek başına önbelleğe alırlar, bu nedenle get_token birden çok bağımlılık tarafından kullanılsa bile sadece bir kez çalışır).
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__ metoduna sahip bir sınıf, yapılandırılabilir bir bağımlılıktır — bunu kullanım zamanında parametreleştirirsiniz (örneğin rota başına farklı hız limitleri).
@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
Bağımlılıkları uygulamaya geniş çapta veya router başına uygulayarak çapraz kesişen gereksinimler için (auth, hız sınırlaması).
app.dependency_overrides[get_db] = get_test_db # swap any dependency in tests
FastAPI'ın bağımlılık enjeksiyonu en güçlü özelliklerinden biridir ve bu gelişmiş desenler, gerçek, karmaşık uygulamaları zarif bir şekilde yapılandırmanıza olanak tanıyan şeydir.
Bunları anlamak değerli üst düzey bilgidir: alt-bağımlılıklar yeniden kullanılabilir katmanlar oluşturur (token → user → admin) otomatik çözüm ve istek başına önbelleğe almayla (gereksiz işi ortadan kaldırır); parametreli/sınıf tabanlı bağımlılıklar yapılandırılabilir, yeniden kullanılabilir bileşenler yaratır (hız limiterleri, rota başına farklı ayarlarla izin kontrolleri); yan etkileri olan bağımlılıklar gereksinimleri temiz bir şekilde uygular (auth) fonksiyon imzasını karmaşıklaştırmadan; ve genel/router düzeyinde bağımlılıklar çapraz kesişen endişeleri (kimlik doğrulama, hız sınırlaması) tüm rota gruplarına tek bir yerde uygularlar.
Önemlisi, bağımlılık geçersiz kılmaları hatta karmaşık bağımlılık graflarını test etmeyi önemsiz hale getiriyor.
Bu desenlerde ustalaşmak — bağımlılıkları birleştirmek, parametreleştirmek, bunları genel olarak veya router başına kapsamlandırmak ve test etmede geçersiz kılmak — trivial olmayan FastAPI uygulamalarında temiz, DRY, test edilebilir mimarinizi etkinleştiren şeydir ve bu da çerçevenin DI sisteminden tam olarak yararlanabilen geliştiricileri sadece temel Depends kullananlardan ayırır.
Bu, iyi yapılandırılmış, sürdürülebilir, büyük ölçekli FastAPI uygulamaları oluşturmak için önemli bir konudur.