واجهة REST بـ FastAPI مع اختبارات
Python Development Lab
وصف المشروع
يتعلم المشارك تحويل مواصفات واجهة إلى كود مختبر بمساعدة وكيل ومهارة fastapi-router-py.
الأدوات المستخدمة
يمكن استبدال الوكيل بأي وكيل برمجة مشابه؛ الخطوات مكتوبة بحيث لا تعتمد على أداة واحدة.
المتطلبات
- Python 3.10+
- fastapi
- uvicorn
- pytest
- httpx
خطوات التنفيذ
تهيئة البيئة
أنشئ بيئة افتراضية وثبّت الحزم.
كود / أوامرpython -m venv .venv pip install fastapi uvicorn pytest httpxتوليد النقاط
اطلب النقاط مع نماذج Pydantic.
Prompt لهذه الخطوةأنشئ واجهة FastAPI لإدارة المهام ...الاختبار
شغّل الاختبارات وافتح /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() |
