FastAPI uygulamalarını nasıl test edersiniz?

Question

Accepted Answer

FastAPI, **`TestClient`** (Starlette/httpx üzerine kurulu) ve **dependency injection** sistemi sayesinde son derece test edilebilirdir; bu, mock'lama işlemini önemsiz hale getirir. Testler tipik olarak `pytest` ve `TestClient` kullanarak sunucu çalıştırmadan uygulamaya istek gönderiyor.

## Temel endpoint testi TestClient ile

```python
from fastapi.testclient import TestClient
from main import app

client = TestClient(app)

def test_read_item():
    response = client.get("/items/5")            # send a request to the app in-process
    assert response.status_code == 200
    assert response.json() == {"item_id": 5}

def test_create_item():
    response = client.post("/items", json={"name": "Phone", "price": 999})
    assert response.status_code == 201
    assert response.json()["name"] == "Phone"

def test_validation_error():
    response = client.post("/items", json={"name": "Phone"})   # missing price
    assert response.status_code == 422                          # FastAPI validates automatically
```

`TestClient` uygulamanıza gerçek istekleri işlem içinde gönderir (sunucu gerekmez), böylece tam akışı test edersiniz — yönlendirme, doğrulama, serileştirme — ve durum kodları ile JSON yanıtlarını onaylarsınız.

## Dependency'leri geçersiz kılma (temiz testlerin anahtarı)

```python
# override a dependency with a mock/test version — no real database needed
def override_get_db():
    return test_db_session

app.dependency_overrides[get_db] = override_get_db   # swap the real dependency

def test_with_test_db():
    response = client.get("/users")
    # uses the test database via the override
    app.dependency_overrides.clear()                 # reset after
```

FastAPI'nin `dependency_overrides`, herhangi bir dependency'yi (veritabanı oturumu, auth, harici hizmetler) test double'ı ile **değiştirmenize** izin verir — hızlı, izole testlerin temeli, DI tasarımı tarafından önemsiz hale getirilir.

## Korunan endpoint'leri test etme

```python
def test_protected():
    # override the auth dependency to simulate a logged-in user
    app.dependency_overrides[get_current_user] = lambda: fake_user
    response = client.get("/me")
    assert response.status_code == 200
```

## Test stratejisi

```text
✓ Use a TEST database (separate, or transactions rolled back per test)
✓ Override dependencies (DB, auth, external APIs) for isolation
✓ Test: status codes, response shapes, validation (422s), auth/permissions, edge cases
✓ For async-specific code, use httpx.AsyncClient / pytest-asyncio
✓ Tools: pytest, factory libraries for test data, coverage.py
```

## Neden önemli

Test, güvenilir uygulamalar için gereklidir ve FastAPI, özellikle test edilebilir olup — bunu nasıl test edeceğinizi anlamak, hem kod kalitesi hem de framework'ün *test edilebilirlik için tasarlanmış* olması nedeniyle önemlidir.

**`TestClient`**, işlem içinde tam istek/yanıt akışını test etmeyi kolaylaştırır (sunucu gerekmez), yönlendirme, doğrulama, serileştirme ve yanıtları, istemcilerin yaşayacağı şekilde doğrular.

Basarı özelliği **dependency override'ıdır**: FastAPI dependency injection kullandığından, herhangi bir dependency'yi — veritabanı oturumları, authentication, harici hizmetler — `app.dependency_overrides` aracılığıyla test double'ları ile önemsiz bir şekilde değiştirebilirsiniz, gerçek altyapı olmadan hızlı, izole testleri etkinleştirerek (bu test edilebilirlik, DI tasarımının önemli bir yararıdır).

TestClient'i nasıl kullanacağınızı, izolasyon için dependency'leri geçersiz kılmayı (test veritabanları, mock auth/hizmetler), korunan endpoint'leri test etmeyi ve makul bir test stratejisini yapılandırmayı (durum kodları, yanıt şekilleri, doğrulama, auth, kenar durumları) bilmek, robust FastAPI uygulamaları oluşturmak için önemli senior seviyesi bilgisidir.

İyi test edilmiş API'ler regresyonları yakalar ve güvenli refactoring'i sağlar, ve FastAPI'nin test araçları kapsamlı test'i basit hale getirir, bu da konuyu sık kullanılan, profesyonelce önemli bir konu haline getirir.