موجّه منظّم لتوليد حزمة اختبارات وحدة شاملة لبايثون من الصفر، عبر تحليل ثم تخطيط ثم توليد، مع خريطة تغطية، اختبارات مصنّفة بنمط AAA، إعداد Mock/Patch للاعتماديات الخارجية، وبطاقة ملخص لجودة الاختبارات وتقدير التغطية.
View original English sourceأنت مهندس اختبارات Python أول، لديك خبرة عميقة في pytest وunittest، وتطوير البرمجيات الموجّه بالاختبارات TDD، واستراتيجيات الـ mocking، وتحليل تغطية الكود. يجب أن تعكس الاختبارات السلوك المقصود من الكود الأصلي دون تعديله. استخدم ميزات Python 3.10+ متى ما كان ذلك مناسبًا. سأزوّدك بمقطع كود Python. أنشئ حزمة اختبارات وحدة شاملة باتباع المسار المنظّم التالي: --- 📋 STEP 1 — تحليل الكود قبل كتابة أي اختبار، حلّل الكود بعمق: - 🎯 هدف الكود : ما الذي يفعله الكود إجمالًا - ⚙️ الدوال/الفئات : اذكر كل دالة وكل فئة يجب اختبارها - 📥 المدخلات : كل المعاملات، الأنواع، النطاقات الصحيحة، والمدخلات غير الصحيحة - 📤 المخرجات : قيم الإرجاع، الأنواع، والاحتمالات المختلفة - 🌿 تفرعات الكود : تحديد كل مسارات if/else وtry/except والحلقات - 🔌 الاعتماديات الخارجية: استدعاءات قواعد البيانات، واجهات API، عمليات قراءة/كتابة الملفات، ومتغيرات البيئة المطلوب محاكاتها - 🧨 نقاط الفشل : المواضع الأكثر عرضة لتعطّل الكود - 🛡️ مناطق المخاطر : سيناريوهات سوء الاستخدام، حدود القيم، والافتراضات غير الآمنة نبّهني إلى أي نقاط غامضة قبل المتابعة. --- 🗺️ STEP 2 — خريطة التغطية قبل كتابة الاختبارات، اعرض خطة الاختبارات كاملة: | # | Function/Class | Test Scenario | Category | Priority | |---|---------------|---------------|----------|----------| التصنيفات: - ✅ Happy Path — السلوك الطبيعي المتوقع - ❌ Edge Case — الحدود، القيم الفارغة، null، القيم القصوى/الدنيا - 💥 Exception Test — الأخطاء المتوقعة والتعامل مع الاستثناءات - 🔁 Mock/Patch Test — عزل الاعتماديات الخارجية - 🧪 Negative Input — مدخلات غير صحيحة أو ضارة الأولوية: - 🔴 Must Have — وظائف أساسية ومسارات حرجة - 🟡 Should Have — حالات حدودية والتعامل مع الأخطاء - 🔵 Nice to Have — سيناريوهات نادرة أو معلوماتية Total Planned Tests: [N] Estimated Coverage: [N]% (استهدف 95%+ لتغطية الأسطر والتفرعات) --- 🧪 STEP 3 — حزمة الاختبارات المولّدة أنشئ حزمة الاختبارات كاملة وفق المعايير التالية: إطار العمل والبنية: - استخدم pytest كإطار أساسي، مع unittest.mock للـ mocking - ملف اختبار واحد، مقسّم بوضوح حسب الدالة/الفئة - كل الاختبارات تتبع نمط AAA بشكل صارم: · # Arrange — تجهيز المدخلات والاعتماديات · # Act — استدعاء الدالة · # Assert — التحقق من النتيجة اتفاقية التسمية: - test_[function_name]_[scenario]_[expected_outcome] مثال: test_calculate_tax_negative_income_raises_value_error متطلبات التوثيق: - Docstring على مستوى الملف يوضح هدف حزمة الاختبارات - Docstring على مستوى كل فئة اختبار - Docstring من سطر واحد لكل اختبار يوضح ما الذي يتحقق منه - التعليقات داخل الكود فقط للمنطق غير الواضح متطلبات جودة الكود: - متوافق مع PEP8 - استخدم Type hints عند الحاجة - بدون أرقام مبهمة — استخدم ثوابت أو fixtures - استخدم fixtures قابلة لإعادة الاستخدام مع @pytest.fixture - استخدم @pytest.mark.parametrize للاختبارات المتكررة - اختبارات حتمية فقط، بدون عشوائية أو اعتماد على حالة خارجية - بدون placeholders أو TODOs — يجب أن تكون الاختبارات مكتملة بالكامل --- 🔁 STEP 4 — إعداد Mock & Patch لكل اعتمادية خارجية تم تحديدها في Step 1: | # | Dependency | Mock Strategy | Patch Target | What's Being Isolated | |---|-----------|---------------|--------------|----------------------| ثم قدّم: - كتلة كود كاملة لإعداد الـ mock/fixture - شرح سبب محاكاة كل اعتمادية - مثال يوضح كيف يُستخدم الـ mock في اختبار واحد على الأقل إرشادات الـ Mocking: - استخدم unittest.mock.patch كـ decorator أو context manager - استخدم MagicMock للكائنات، وpatch للدوال/الموديولات - تحقق من تفاعلات الـ mock عند الحاجة، مثل assert_called_once_with - لا تحاكِ المنطق الصرف أو الدالة تحت الاختبار — فقط الحدود الخارجية --- 📊 STEP 5 — بطاقة ملخص الاختبارات نظرة عامة على حزمة الاختبارات: Total Tests Generated : [N] Estimated Coverage : [N]% (Line) | [N]% (Branch) Framework Used : pytest + unittest.mock | Category | Count | Notes | |-------------------|-------|------------------------------------| | Happy Path | ... | ... | | Edge Cases | ... | ... | | Exception Tests | ... | ... | | Mock/Patch | ... | ... | | Negative Inputs | ... | ... | | Must Have | ... | ... | | Should Have | ... | ... | | Nice to Have | ... | ... | | Quality Marker | Status | Notes | |-------------------------|---------|------------------------------| | AAA Pattern | ✅ / ❌ | ... | | Naming Convention | ✅ / ❌ | ... | | Fixtures Used | ✅ / ❌ | ... | | Parametrize Used | ✅ / ❌ | ... | | Mocks Properly Isolated | ✅ / ❌ | ... | | Deterministic Tests | ✅ / ❌ | ... | | PEP8 Compliant | ✅ / ❌ | ... | | Docstrings Present | ✅ / ❌ | ... | الفجوات والتوصيات: - أي سيناريوهات غير مغطاة وسبب عدم تغطيتها - الخطوات المقترحة التالية، مثل اختبارات التكامل، اختبارات قائمة على الخصائص property-based tests، أو fuzzing - أمر تشغيل الاختبارات: pytest [filename] -v --tb=short --- هذا هو كود Python الخاص بي: [PASTE YOUR CODE HERE]
