আপনি কীভাবে FastAPI অ্যাপ্লিকেশন পরীক্ষা করেন?

Question

Accepted Answer

FastAPI অত্যন্ত পরীক্ষণযোগ্য কারণ এটি **`TestClient`** (Starlette/httpx এর উপর ভিত্তি করে) এবং এর **dependency injection** সিস্টেম রয়েছে, যা মকিং ডিপেন্ডেন্সি তুচ্ছ করে তোলে। পরীক্ষাগুলি সাধারণত `pytest` এবং `TestClient` ব্যবহার করে চলমান সার্ভার ছাড়াই অ্যাপে অনুরোধ পাঠায়।

## TestClient দিয়ে বেসিক এন্ডপয়েন্ট পরীক্ষা

```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 — পরীক্ষা করেন এবং status codes এবং JSON responses এ assertion করেন।

## ডিপেন্ডেন্সি ওভাররাইড করা (পরিষ্কার পরীক্ষার চাবিকাঠি)

```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, বাহ্যিক সেবা) একটি test double দিয়ে — দ্রুত, বিচ্ছিন্ন পরীক্ষার ভিত্তি, DI ডিজাইন দ্বারা তুচ্ছ করা হয়েছে।

## সুরক্ষিত এন্ডপয়েন্ট পরীক্ষা

```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, এবং responses যাচাই করে যেমন ক্লায়েন্টরা তাদের অনুভব করবে।

দাঁড়িয়ে থাকা বৈশিষ্ট্য হল **dependency overrides**: কারণ FastAPI dependency injection ব্যবহার করে, আপনি trivially যেকোনো ডিপেন্ডেন্সি প্রতিস্থাপন করতে পারেন — ডাটাবেস সেশন, authentication, বাহ্যিক সেবা — `app.dependency_overrides` এর মাধ্যমে test doubles দিয়ে, দ্রুত, বিচ্ছিন্ন পরীক্ষা সক্ষম করে বাস্তব অবকাঠামো ছাড়াই (এই পরীক্ষণযোগ্যতা DI ডিজাইনের একটি প্রধান সুবিধা)।

কীভাবে TestClient ব্যবহার করতে হয়, বিচ্ছিন্নতার জন্য ডিপেন্ডেন্সি ওভাররাইড করতে হয় (পরীক্ষা ডাটাবেস, mocked auth/services), সুরক্ষিত এন্ডপয়েন্ট পরীক্ষা করতে হয়, এবং একটি যুক্তিসঙ্গত পরীক্ষার কৌশল তৈরি করতে হয় (status codes, response shapes, validation, auth, edge cases) জানা সিনিয়র-স্তরের জ্ঞান শক্তিশালী FastAPI অ্যাপ্লিকেশন তৈরির জন্য।

ভালভাবে-পরীক্ষিত APIs রিগ্রেশন ধরে এবং আত্মবিশ্বাসী রিফ্যাক্টরিং সক্ষম করে, এবং FastAPI এর পরীক্ষার সরঞ্জাম পুঙ্খানুপুঙ্খ পরীক্ষা সহজ করে, এটি একটি ঘন ঘন-প্রাসঙ্গিক, পেশাদারভাবে-গুরুত্বপূর্ণ বিষয় করে তোলে।