FastAPI अनुप्रयोगहरू कसरी परीक्षण गर्नुहुन्छ?

Question

Accepted Answer

FastAPI यसको **`TestClient`** (Starlette/httpx मा निर्मित) र यसको **निर्भरता इन्जेक्शन** प्रणालीको कारण अत्यधिक परीक्षणयोग्य छ, जसले मक निर्भरताहरू तुच्छ बनाएको छ। परीक्षणहरू सामान्यतः `pytest` र `TestClient` प्रयोग गरी चलिरहेको सर्भर बिना अनुप्रयोगमा अनुरोध पठाउँछन्।

## 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` तपाईंको अनुप्रयोगमा प्रक्रियामा वास्तविक अनुरोध पठाउँछ (कुनै सर्भर आवश्यक छैन), त्यसैले तपाई पूर्ण प्रवाह — routing, validation, serialization — परीक्षण गर्नुहुन्छ र स्थिति कोडहरू र JSON प्रतिक्रियाहरूमा दावी गर्नुहुन्छ।

## निर्भरताहरू अनुमति दिँदै (सफा परीक्षणको कुञ्जी)

```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` ले तपाईलाई **कुनै पनि निर्भरता** (डेटाबेस सत्र, auth, बाह्य सेवाहरू) परीक्षण डबलसँग **बदलन** अनुमति दिन्छ — यो द्रुत, अलगाइएको परीक्षणको आधार हो, 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 उल्लेखनीय रूपमा परीक्षणयोग्य छ — यसलाई कसरी परीक्षण गर्ने भन्ने बुझ्न कोड गुणस्तर र ढाँचा *डिजाइन गरिएको* परीक्षणयोग्यताको कारणले महत्त्वपूर्ण छ।

**`TestClient`** पूर्ण request/response प्रवाह प्रक्रियामा परीक्षण गर्न सजिलो बनाएको छ (कुनै सर्भर आवश्यक छैन), routing, validation, serialization, र प्रतिक्रियाहरू सत्यापन गर्दै जसरी ग्राहकहरू अनुभव गर्नेछन्।

भुइं विशेषता **निर्भरता अनुलिखन** हो: किनकि FastAPI निर्भरता इन्जेक्शन प्रयोग गरेको कारणले, तपाई तुच्छ रूपमा कुनै पनि निर्भरता — डेटाबेस सत्र, प्रमाणीकरण, बाह्य सेवाहरू — परीक्षण डबलसँग बदलन सक्नुहुन्छ `app.dependency_overrides` मार्फत, द्रुत, अलगाइएको परीक्षण सक्षम गर्दै वास्तविक अवसंरचना बिना (यो परीक्षणयोग्यता DI डिजाइनको प्रमुख लाभ हो)।

TestClient कसरी प्रयोग गर्ने, अलगीकरणको लागि निर्भरताहरू अनुलिखन गर्ने (परीक्षण डेटाबेस, mocked auth/services), संरक्षित endpoints परीक्षण गर्ने, र समझदारीपूर्ण परीक्षण रणनीति (स्थिति कोडहरू, प्रतिक्रिया आकारहरू, validation, auth, edge cases) संरचना गर्ने बुझ्न वरिष्ठ-स्तरको ज्ञान हो मजबूत FastAPI अनुप्रयोग निर्माणको लागि।

सुदृढ परीक्षण गरिएका APIs प्रतिगमन पकडेको छ र आत्मविश्वासपूर्ण refactoring सक्षम गर्दछ, र FastAPI को परीक्षण उपकरणहरूले पूर्ण परीक्षण सीधा बनाएको छ, यो बारम्बार-प्रासंगिक, व्यावसायिक-महत्त्वपूर्ण विषय बनाएको छ।