AI CodeOps

خدمة Python: الاختبارات أولا، مع حد أدنى للتغطية في CI

آخر تحديث

اكتب اختبارات pytest الناقصة بسير العمل Quality-Gated Change، وسجل التغطية من pytest-cov داخل البيئة المعزولة، واجعل CI يرفض الدمج تحت حد أدنى للتغطية قدره 80%.

استخدم هذا القالب

كود الأسعار غير المختبر هو مصدر عمليات الاسترداد. وهذا القالب يطلب من الوكلاء كتابة الاختبارات الناقصة أولا، ويشغلها على الكود الذي كتب فعلا، ويعطي CI لديك حدا أدنى للتغطية يفرضه.

الوكلاء الذين يعملون

سير العمل Quality-Gated Change أقصر مسارات سير العمل التي تكتب الكود، ولا خطوة تخطيط فيه:

  1. Build، ويتولاها وكيل Builder: ملف الاختبارات وأي إصلاح تستدعيه الحالات.
  2. Test، ويتولاها وكيل Tester: حالات مسماة للمسار السليم والحالات الحدية وحالات الفشل، مفحوصة في ضوء الاختبارات التي كتبت ونتيجتها المسجلة.
  3. Review، ويتولاها وكيل Reviewer: هل تتحقق الاختبارات من سلوك حقيقي أم تكتفي بتشغيل الأسطر.

تكتب جولة كتابة الكود التغيير مباشرة بعد Build. ثم تعيد خطوة التحقق (verify) بناءه داخل بيئة معزولة، وتثبت التبعيات، وتقطع الشبكة، وتشغل أمر الاختبار لديك. وتعمل Test و Review بعد ذلك، على التغيير المكتوب. ويحلل ملخص pytest إلى ناجح وفاشل ومتخطى، ويسجل سطر التغطية TOTAL من pytest-cov على أنه رقم التغطية الإجمالي.

اضبط أمر الاختبار

اضبط في المشروع ما يلي:

حقل المشروعقيمة مثال
Test commandpytest -q --cov=app --cov-report=term

من دون أمر، يكتشف AI CodeOps وجود pytest من pyproject.toml أو setup.cfg أو pytest.ini أو tox.ini، لكنه يشغل pytest -q دون تغطية. وعندها لا يبلغ التشغيل عن أي تغطية، ويرفض الحد الأدنى للتغطية في CI التغيير لأنه لا يمكن التحقق منه. لذلك اضبط الأمر. ولكل أمر حد زمني قدره دقيقتان.

البوابات السارية

  • الاختبارات الفاشلة تمنع طلب السحب، ولا تحتسب إلا نتيجة الإصدار الحالي من التغيير.
  • الملاحظات المفتوحة بخطورة high أو critical تمنع إلى أن تفرز.
  • يوافق شخص غير الذي بدأ الجلسة، حين يكون في مساحة العمل شخص آخر يملك صلاحية الموافقة.

افرض الحد الأدنى في CI

لا تطبق البوابة على التغطية إلا حين يطلب خط CI لديك ذلك. مرر عنوان طلب السحب وحدا أدنى، كما يلي:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"minCoveragePct\":80}" \
  | jq -e '.allowed == true'

يجب أن يبلغ أحدث تشغيل اختبار أبلغ عن التغطية القيمة 80، وإلا كان الرد رفضا مع coverageShortfall، مثل "Coverage 71% is below the required 80%". وإذا لم يبلغ أي تشغيل اختبار على التغيير عن التغطية، يكون الرد رفضا أيضا: "Coverage wasn't reported, so the 80% floor can't be checked". ويسري الحد الأدنى على كل ما يقيسه أمرك، فالخيار --cov=app يطبق البوابة على الحزمة كلها، لا على الملف الذي غيرته فقط. وتفاصيل الحقول في مرجع فحص الإصدار.

ولجانب التبعيات في الخدمة نفسها، راجع قالب SBOM وبوابة التراخيص.

الأسئلة الشائعة

هل تفحص بوابة الجودة الخاصة بكل تشغيل التغطية؟

لا. الحد الأدنى للتغطية خيار في CI. فبوابة التشغيل نفسها تفحص الاختبارات والملاحظات والموافقة؛ ولا يطبق minCoveragePct إلا حين يطلبه CI لديك.

ماذا لو تعذر على البيئة المعزولة تثبيت pytest-cov؟

تسجل خطوة التحقق تخطيا مع السبب، لا فشلا ولا نجاحا. أضف pytest-cov إلى التبعيات التي يثبتها مشروعك.