واجهة REST بـ FastAPI مع اختبارات

Python Development Lab

مختبر تطوير Pythonالمستوى: متوسط المدة: ساعتان

وصف المشروع

يتعلم المشارك تحويل مواصفات واجهة إلى كود مختبر بمساعدة وكيل ومهارة fastapi-router-py.

الأدوات المستخدمة

يمكن استبدال الوكيل بأي وكيل برمجة مشابه؛ الخطوات مكتوبة بحيث لا تعتمد على أداة واحدة.

المتطلبات

  • Python 3.10+
  • fastapi
  • uvicorn
  • pytest
  • httpx

خطوات التنفيذ

  1. تهيئة البيئة

    أنشئ بيئة افتراضية وثبّت الحزم.

    كود / أوامر
    python -m venv .venv
    pip install fastapi uvicorn pytest httpx
  2. توليد النقاط

    اطلب النقاط مع نماذج Pydantic.

    Prompt لهذه الخطوة
    أنشئ واجهة FastAPI لإدارة المهام ...
  3. الاختبار

    شغّل الاختبارات وافتح /docs.

    Prompt لهذه الخطوة
    اكتب اختبارات pytest ...
    كود / أوامر
    pytest -q

Prompts جاهزة

المواصفات
أنشئ واجهة FastAPI لإدارة المهام: GET /tasks وPOST /tasks وPATCH /tasks/{id} وDELETE /tasks/{id}. استخدم نماذج Pydantic للتحقق، وخزّن البيانات في الذاكرة الآن.
الاختبارات
اكتب اختبارات pytest باستخدام fastapi.testclient.TestClient تغطي كل نقطة، بما فيها حالة 404.

مثال من الكود الناتج

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()

class TaskIn(BaseModel):
    title: str
    done: bool = False

class Task(TaskIn):
    id: int

TASKS: dict[int, Task] = {}

@app.post("/tasks", status_code=201)
def create(t: TaskIn) -> Task:
    task = Task(id=len(TASKS) + 1, **t.model_dump())
    TASKS[task.id] = task
    return task

@app.get("/tasks/{task_id}")
def read(task_id: int) -> Task:
    if task_id not in TASKS:
        raise HTTPException(404, "Task not found")
    return TASKS[task_id]

مثال توضيحي لما يُتوقع أن ينتجه الوكيل؛ قد يختلف الناتج الفعلي، فراجعه واختبره دائماً.

الاختبارات

  • pytest -q
  • uvicorn main:app --reload ثم فتح /docs

النتائج المتوقعة

  • توثيق تفاعلي على /docs
  • اختبارات ناجحة لكل النقاط

الأخطاء الشائعة وحلولها

الخطأالحل
استخدام dict() في Pydantic v2استخدم model_dump()

روابط الوثائق