તમે FastAPI એપ્લિકેશનોની કસોટી કેવી રીતે કરો છો?

Question

Accepted Answer

FastAPI તેના **`TestClient`** (Starlette/httpx પર આધારિત) અને તેની **dependency injection** સિસ્ટમ માટે આભારી છે, જે dependencies ને mock કરવાનું તુચ્છ બનાવે છે. પરીક્ષણો સામાન્ય રીતે `pytest` અને `TestClient` નો ઉપયોગ કરે છે જેથી ચલતા સર્વર વિના app ને requests મોકલી શકાય.

## TestClient સાથે મૂળભૂત endpoint પરીક્ષણ

```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` તમારા app ને in-process માં વાસ્તવિક requests મોકલે છે (કોઈ સર્વર જરૂરી નથી), તેથી તમે સંપૂર્ણ પ્રવાહ — routing, validation, serialization — ની કસોટી કરો છો અને status codes અને JSON responses પર assertions કરો છો.

## Dependencies ને override કરવું (સ્વચ્છ પરીક્ષણોની ચાવી)

```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 ના `dependency_overrides` તમને **કોઈપણ dependency** (database session, auth, external services) ને test double સાથે **બદલવા** દે છે — ઝડપી, અલગ કરેલા પરીક્ષણોનું ভিત્તિ, DI ડિઝાઇન દ્વારા તુચ્છ બનાવેલું.

## સુરક્ષિત endpoints ની કસોટી કરવી

```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
```

## કસોટીની વ્યૂહરચના

```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
```

## તે શા માટે મહત્ત્વપૂર્ણ છે

પરીક્ષણ વિશ્વાસપાત્ર એપ્લિકેશનો માટે આવશ્યક છે, અને FastAPI નોંધપાત્ર રીતે પરીક્ષણીય છે — તેને કેવી રીતે પરીક્ષણ કરવું તે સમજવું કોડ ગુણવત્તા અને કારણ કે framework તેની *ડિઝાઇન* દ્વારા પરીક્ષણીયતા માટે બનાવવામાં આવ્યું છે એ બંને માટે મહત્ત્વપૂર્ણ છે.

**`TestClient`** in-process માં સંપૂર્ણ request/response પ્રવાહ પરીક્ષણ કરવાનું સરળ બનાવે છે (કોઈ સર્વર જરૂરી નથી), routing, validation, serialization, અને responses ને ચકાસે છે જેમ ક્લાયન્ટ્સ તેમનો અનુભવ કરશે.

ઉત્કૃષ્ટ વૈશિષ્ટ્ય **dependency overrides** છે: કારણ કે FastAPI dependency injection નો ઉપયોગ કરે છે, તમે કોઈપણ dependency — database sessions, authentication, external services — ને `app.dependency_overrides` દ્વારા test doubles સાથે તુચ્છ રીતે બદલી શકો છો, વાસ્તવિક માળખું વિના ઝડપી, અલગ કરેલા પરીક્ષણો સક્ષમ કરી શકો છો (આ પરીક્ષણીયતા DI ડિઝાઇનનો મોટો લાભ છે).

TestClient નો ઉપયોગ કેવી રીતે કરવો, isolation માટે dependencies override કરવી (test databases, mocked auth/services), સુરક્ષિત endpoints ની કસોટી કરવી, અને સમજદારીપૂર્ણ પરીક્ષણ વ્યૂહરચના રચવી (status codes, response shapes, validation, auth, edge cases) તે જાણવું વરિષ્ઠ-સ્તરનું જ્ઞાન છે મજબૂત FastAPI એપ્લિકેશનો બનાવવા માટે.

સુચોક્તું પરીક્ષણ કરાયેલ APIs પુનરાવર્તનો પકડે છે અને આત્મવિશ્વાસ સાથે refactoring સક્ષમ કરે છે, અને FastAPI ના પરીક્ષણ સાધનો સંપૂર્ણ પરીક્ષણ સીધું બનાવે છે, આને બારંબાર-સંબંધિત, વ્યાવસાયિક રીતે-મહત્ત્વપૂર્ણ વિષય બનાવે છે.