FastAPI: واجهات بايثون حديثة

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

1أول مسار والتوثيق المجاني

دالة عادية بمزخرف @app.get. المعامل item_id: int في المسار يتحوّل لرقم ويُرفض النص تلقائيًا. افتح /docs فترى كل مساراتك وتجرّبها من المتصفح.

from fastapi import FastAPI

app = FastAPI(title="Cafe API")

@app.get("/drinks/{item_id}")
def read_drink(item_id: int, size: str = "medium"):
    return {"id": item_id, "size": size}

# run with:  pip install "fastapi[standard]"  then  fastapi dev main.py

2Pydantic: البيانات بعقد

نموذج Pydantic صنف بأنواع وقيود. يحوّل ويتحقّق ويعطي أخطاء مفصّلة. هذا المثال يعمل بلا خادم لترى التحقّق وحده (يحتاج تثبيت pydantic).

from typing import Literal
from pydantic import BaseModel, Field, ValidationError

class Order(BaseModel):
    item: Literal["latte", "mocha", "v60"]
    cups: int = Field(ge=1, le=10)
    note: str | None = Field(default=None, max_length=80)

print(Order(item="latte", cups="2"))           # "2" becomes 2
try:
    Order(item="tea", cups=0)
except ValidationError as e:
    for err in e.errors():
        print(err["loc"][0], "->", err["msg"])

3Depends: اعتماديات قابلة للتبديل

ما تحتاجه دوال كثيرة (المستخدم الحالي، جلسة قاعدة البيانات) تكتبه دالة واحدة وتطلبه بـ Depends. وفي الاختبار تستبدلها بنسخة وهمية.

from fastapi import Depends, Header, HTTPException

def current_user(authorization: str = Header()):
    if authorization != "Bearer demo-token":
        raise HTTPException(status_code=401, detail="log in first")
    return {"name": "Sara"}

@app.get("/me")
def me(user: dict = Depends(current_user)):
    return user

4Flask أم FastAPI أم Express؟

Flask بسيط ومرن ومناسب للتعلّم والمواقع الصغيرة. FastAPI حين تريد أنواعًا وتحقّقًا وتوثيقًا تلقائيًا، خصوصًا مع نماذج الذكاء الاصطناعي في بايثون. Express حين فريقك يكتب JavaScript في الواجهة ويريد لغة واحدة.

مثال محلول

واجهة الطلبات بـ FastAPI مع اختبار. لاحظ أنك لا تكتب أي تحقّق يدوي، وأن الخطأ 422 يحدّد الحقل.

from typing import Literal
from fastapi import FastAPI, HTTPException
from fastapi.testclient import TestClient
from pydantic import BaseModel, Field

app = FastAPI()

class NewOrder(BaseModel):
    item: Literal["latte", "mocha", "v60"]
    cups: int = Field(ge=1, le=10)

class Order(NewOrder):
    id: int

ORDERS: list[Order] = []

@app.post("/orders", status_code=201, response_model=Order)
def create(order: NewOrder):
    saved = Order(id=len(ORDERS) + 1, **order.model_dump())
    ORDERS.append(saved)
    return saved

@app.get("/orders/{order_id}", response_model=Order)
def get(order_id: int):
    for o in ORDERS:
        if o.id == order_id:
            return o
    raise HTTPException(404, "no such order")

client = TestClient(app)
assert client.post("/orders", json={"item": "latte", "cups": 2}).status_code == 201
bad = client.post("/orders", json={"item": "tea", "cups": 0})
assert bad.status_code == 422
print([e["loc"][-1] for e in bad.json()["detail"]])   # ['item', 'cups']

خرافة مقابل حقيقة

اختبر فهمك

بطاقات مراجعة سريعة

تحقق من فهمك