كيف تختبر تطبيقات FastAPI؟

Question

Accepted Answer

FastAPI قابل للاختبار بدرجة عالية بفضل **`TestClient`** (المبني على Starlette/httpx) ونظام **حقن التبعيات** الخاص به، مما يجعل محاكاة التبعيات سهلة جداً. عادةً ما تستخدم الاختبارات `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` طلبات حقيقية إلى تطبيقك في نفس العملية (لا يلزم خادم)، لذلك تختبر التدفق الكامل — التوجيه والتحقق من الصحة والتسلسل — وتؤكد على رموز الحالة واستجابات 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
```

يتيح `dependency_overrides` الخاص بـ FastAPI **استبدال أي تبعية** (جلسة قاعدة البيانات والمصادقة والخدمات الخارجية) بنسخة اختبار — الأساس للاختبارات السريعة والمعزولة، والتي يجعلها تصميم 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`** يجعل من السهل اختبار التدفق الكامل للطلب/الاستجابة في نفس العملية (لا حاجة لخادم)، مما يتحقق من التوجيه والتحقق من الصحة والتسلسل والاستجابات تماماً كما يختبرها العملاء.

الميزة البارزة هي **تجاوز التبعيات**: لأن FastAPI يستخدم حقن التبعيات، يمكنك بسهولة استبدال أي تبعية — جلسات قاعدة البيانات والمصادقة والخدمات الخارجية — بنسخ اختبار عبر `app.dependency_overrides`، مما يتيح اختبارات سريعة ومعزولة بدون البنية التحتية الحقيقية (هذه القابلية للاختبار هي فائدة رئيسية من تصميم DI).

معرفة كيفية استخدام TestClient وتجاوز التبعيات للعزل (قواعد بيانات الاختبار والمصادقة/الخدمات المحاكاة) واختبار نقاط النهاية المحمية وهيكلة استراتيجية اختبار معقولة (رموز الحالة وأشكال الاستجابة والتحقق من الصحة والمصادقة والحالات الحدية) معرفة مهمة على المستوى الأعلى لبناء تطبيقات FastAPI قوية.
	ing من الأخطاء الانحدارية وتمكين إعادة البناء بثقة، وأدوات اختبار FastAPI تجعل الاختبار الشامل واضحاً ومباشراً، مما يجعل هذا موضوعاً يتعلق بشكل متكرر ومهماً من الناحية المهنية.

الواجهات البرمجية المختبرة بشكل جيد توفر الحماية من الأخطاء الانحدارية وتمكين إعادة البناء بثقة، وأدوات اختبار FastAPI تجعل الاختبار الشامل واضحاً ومباشراً، مما يجعل هذا موضوعاً يتعلق بشكل متكرر ومهماً من الناحية المهنية.