Dependency injection (Depends) nasıl çalışır?

Question

Accepted Answer

FastAPI'nin **dependency injection** sistemi, yeniden kullanılabilir bağımlılıkları (fonksiyonlar/sınıflar) bildirmenizi sağlar ve FastAPI bunları `Depends()` aracılığıyla path operasyonlarınıza çağırıp **inject** eder. Veritabanı oturumları, kimlik doğrulama ve ortak parametreler gibi paylaşılan mantık için kullanılır — kodu DRY ve test edilebilir tutar.

## Temel bir bağımlılık

```python
from fastapi import Depends

# a dependency is just a callable that returns something
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI calls pagination() and injects the result
    return params
# the skip/limit query params are now handled by the reusable dependency
```

`params = Depends(pagination)` bildirmek, FastAPI'ye `pagination` öğesini çağırmasını (onun parametrelerini de istekten çözmesini) ve sonucu fonksiyonunuza geçirmesini söyler. Bağımlılık birçok endpoint arasında yeniden kullanılabilir.

## Temizlikli bağımlılıklar (yield) — örn. veritabanı oturumları

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # provide the session to the endpoint
    finally:
        db.close()                # cleanup runs AFTER the response — guaranteed

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # uses the injected, auto-closed session
```

Bir `yield` bağımlılığı, bir kaynak sağlar ve istekten sonra temizliği çalıştırır — veritabanı oturumları için standart desen (açın, sonra kapatın, otomatik olarak).

## Bağımlılıklar bağımlılıklara bağlı olabilir

```python
def get_current_user(token: str = Depends(get_token)):   # depends on another dependency
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth via injection
    return user
```

Bağımlılıklar bir ağaç oluşturur — FastAPI tüm zinciri çözer. Kimlik doğrulama tipik olarak bu şekilde yapılır (`get_current_user` bağımlılığı).

## Sınıf bağımlılıkları ve yeniden kullanım

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # run a dependency without using its return
def items(): ...                                              # e.g. enforce auth as a side effect
```

## Neden önemli

Dependency injection, FastAPI'nin en güçlü ve önemli özelliklerinden biridir — mantığı endpoint'ler arasında temiz bir şekilde paylaşıp yeniden kullanmanın yoludur (veritabanı oturumları, kimlik doğrulama, ortak sorgu parametreleri, izin kontrolleri) tekrar yazmadan.

Bunu anlamak önemlidir çünkü temel desenleri destekler: **`yield` bağımlılığı** veritabanı oturumlarını yönetmenin standart yoludur (her istekten sonra garantili temizlikle), ve **`get_current_user` bağımlılığı** kimlik doğrulamayı uygulamanın idiyomatik yoludur.

DI ayrıca kodu oldukça **test edilebilir** yapar — testlerde bağımlılıkları mock'larla geçersiz kılabilirsiniz.

Sistem'in zarafeti (bağımlılıklar kendi parametrelerini istekten çözer, diğer bağımlılıklara bağlı olabilirler bir ağaç oluşturarak ve dokümanlarla entegre olurlar) onu gerçek uygulamaları yapılandırmak için çok yönlü bir araç yapar, bu nedenle `Depends` öğesinde uzmanlaşmak, iyi organize edilmiş, bakımı kolay, test edilebilir FastAPI uygulamaları oluşturmak için anahtardır.