FastAPI اپنے TestClient (Starlette/httpx پر بنایا گیا) اور اپنے dependency injection نظام کی وجہ سے انتہائی قابل ٹیسٹ ہے، جو dependencies کو mock کرنا معمولی بناتا ہے۔ ٹیسٹز عام طور پر pytest اور TestClient استعمال کرتے ہیں تاکہ چلتے ہوئے سرور کے بغیر ایپ کو requests بھیجیں۔
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 آپ کی ایپ کو in-process میں حقیقی requests بھیجتا ہے (کوئی سرور کی ضرورت نہیں)، اس لیے آپ مکمل بہاؤ — routing، validation، serialization — کو ٹیسٹ کرتے ہیں اور status codes اور JSON responses پر assert کرتے ہیں۔
# 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، بیرونی سروسز) کو ایک test double سے بدلنے دیتا ہے — تیز، الگ تھلگ ٹیسٹس کی بنیاد، DI ڈیزائن کے ذریعے معمولی بنایا گیا۔
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
✓ 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 بہاؤ کو in-process میں ٹیسٹ کرنا آسان بناتا ہے (کوئی سرور کی ضرورت نہیں)، routing، validation، serialization، اور responses کی تصدیق کرتے ہوئے جیسے کلائنٹس انہیں سمجھیں گے۔
نمایاں خصوصیت dependency overrides ہے: کیونکہ FastAPI dependency injection استعمال کرتا ہے، آپ آسانی سے کسی بھی dependency — database sessions، authentication، بیرونی سروسز — کو app.dependency_overrides کے ذریعے test doubles سے بدل سکتے ہیں، تیز، الگ تھلگ ٹیسٹس قابل بناتے ہوئے حقیقی infrastructure کے بغیر (یہ testability DI ڈیزائن کا ایک اہم فائدہ ہے)۔
جاننا کہ TestClient کو کیسے استعمال کریں، isolation کے لیے dependencies کو override کریں (ٹیسٹ databases، mocked auth/services)، محفوظ endpoints کو ٹیسٹ کریں، اور سمجھدارانہ ٹیسٹنگ حکمت عملی (status codes، response shapes، validation، auth، edge cases) کو structure کریں یہ مضبوط FastAPI ایپلیکیشنز بنانے کے لیے اہم senior-level علم ہے۔
اچھی طریقے سے ٹیسٹ شدہ APIs رegressions کو پکڑتے ہیں اور پر اعتماد refactoring کو قابل بناتے ہیں، اور FastAPI کے ٹیسٹنگ ٹولز جامع ٹیسٹنگ کو سیدھا بناتے ہیں، یہ ایک بار بار متعلقہ، پیشہ ورانہ اہم موضوع بناتے ہوئے۔