إضافة تلميحات الأنواع وفحصها بـ mypy
وصف الاستخدام
رفع جودة كود Python قائم بإضافة الأنواع دون تغيير السلوك.
نص الأمر
الكود في {{project}} ({{stack}}).
أضف تلميحات الأنواع (Type hints) تدريجياً:
1. ابدأ بالوحدات الأساسية الأقل اعتماداً على غيرها.
2. استخدم أنواعاً دقيقة (TypedDict, Protocol, Literal) بدلاً من Any حيث يمكن.
3. شغّل mypy --strict على كل وحدة بعد تعديلها، وأصلح الأخطاء دون تغيير السلوك.
4. شغّل الاختبارات الحالية بعد كل وحدة.
5. اكتب ملخصاً بالوحدات المكتملة والمتبقية وأي أخطاء لم تُحل مع سببها.
{{extra}}المدخلات المطلوبة
مسار المشروع، إصدار Python.
المخرجات المتوقعة
تعديلات بالأنواع، تقرير mypy، نتيجة الاختبارات.
الأدوات المناسبة
مثال تطبيقي
project = «مكتبة معالجة بيانات داخلية» بنحو 40 ملفاً دون أنواع.
لم يُدَّعَ اختبار هذا الأمر على نموذج بعينه؛ النتائج تختلف حسب النموذج والسياق، فراجع المخرجات دائماً.
