Python المقيّد بالأنواع لواجهات API

استخدم تلميحات الأنواع كعقود قابلة للتنفيذ وأبقِ منطق التحويل نقياً.

مبادئ الإنتاج

• تجعل تلميحات الأنواع نية الطلب والاستجابة صريحة
• الدوال النقية أسهل اختباراً من المنطق المرتبط بالمسارات
• يجب نمذجة القيم الاختيارية بصورة مقصودة

مثال عملي

from typing import Any
def normalize_tag(value: str) -> str:    return value.strip().lower().replace(" ", "-")

قائمة تحقق هندسية

1. عرّف العقد العام قبل تفاصيل التنفيذ.
2. تحقّق عند حدود النظام وأبقِ منطق المجال قابلاً للاختبار بصورة مستقلة.
3. اجعل سلوك الفشل صريحاً باستخدام رموز حالة ثابتة وأجسام أخطاء آمنة.
4. اختبر المسار الناجح والمدخلات غير الصالحة والموارد المفقودة وحدود التفويض.

يحوّل FastAPI معلومات أنواع Python إلى تحقق وقت التشغيل وتوثيق OpenAPI، لكن الأنواع لا تغني عن تصميم المجال بعناية.