- الرئيسية
- مسرد المصطلحات
- الحد الأدنى للتغطية (Coverage floor)
الحد الأدنى للتغطية (Coverage floor)
آخر تحديث
الحد الأدنى للتغطية هو أقل تغطية اختبارات يجوز أن يطلق بها تغيير. كيف تضعه الفرق، ومزالقه، وكيف يعمل minCoveragePct في فحص CI من AI CodeOps.
الحد الأدنى للتغطية هو أقل نسبة مئوية لتغطية الاختبارات يجب أن تبلغها قاعدة الكود أو التغيير لاجتياز فحص الجودة. فإذا كانت التغطية المقيسة أقل من الحد الأدنى، يفشل الفحص.
التعريف
تقيس أدوات التغطية مقدار الكود الذي نفذته الاختبارات، وعادة ما يكون ذلك نسبة مئوية من الأسطر أو التعليمات أو الفروع. ويضع الحد الأدنى قيمة دنيا لهذا الرقم، مثل 80% من تغطية الأسطر، وتفشل خطوة CI حين تأتي نتيجة التشغيل أقل منها. وتطبق بعض الفرق الحد الأدنى على المشروع كله، وتطبقه فرق أخرى على الأسطر التي مسها التغيير فقط.
والحد الأدنى يقيس مقدار الكود الذي عمل أثناء الاختبارات، لا ما إذا كانت الاختبارات قد تحققت من أي شيء. فالاختبار الذي لا تأكيدات (assertions) فيه يضيف إلى التغطية مع ذلك.
الأهمية
تميل التغطية إلى التراجع حين لا يراقبها أحد، والحد الأدنى يوقف هذا التراجع. وهو أنفع ما يكون كسقاطة لا ترجع إلى الخلف: ضعه قريبا من رقم اليوم وارفعه كلما تحسنت التغطية. وفي التغييرات التي يكتبها الذكاء الاصطناعي، هو إشارة رخيصة إلى أن الجلسة كتبت اختبارات مع الكود، لا بدلا منه.
في AI CodeOps
الحد الأدنى للتغطية هو الخيار minCoveragePct في فحص الإصدار الذي يستدعيه CI لديك، وهو POST /api/release/check، كما يلي:
{ "pullRequestURL": "https://github.com/acme/checkout/pull/42", "minCoveragePct": 80 }
حين تشغل الجلسة اختباراتك في بيئتها المعزولة، يستخرج AI CodeOps رقم التغطية من مخرجات الاختبار حين تتضمن ملخصا: سطر TOTAL من pytest-cov، أو صف All files من Istanbul (في Jest و Vitest؛ والعمود الأول، وهو التعليمات)، أو سطر موسوم مثل coverage: 85.3%. ويخزن الرقم مع تشغيل الاختبار عددا صحيحا، مقربا إلى الأدنى.
حين يضبط minCoveragePct، يجب أن يبلغه أحدث تشغيل اختبار أبلغ عن التغطية. والنقص عنه يرفض الإصدار:
{
"allowed": false,
"reasons": ["Coverage 71% is below the required 80%"],
"coverageShortfall": { "coveragePct": 71, "required": 80 },
"coverageNotReported": null
}
وهناك تفصيلان مهمان:
- لا تغطية مبلغ عنها، لا نجاح. إذا لم يبلغ أي تشغيل اختبار على التغيير عن التغطية، فلا يمكن التحقق من الحد الأدنى، فيرفض الإصدار بالرسالة "Coverage wasn't reported, so the 80% floor can't be checked". ويحمل الرد حينها
"coverageNotReported": { "required": 80 }. اجعل أمر الاختبار في مشروعك يطبع ملخصا للتغطية، مثلpytest --covأوvitest run --coverage، قبل أن تضع حدا أدنى. - في CI فقط. بوابة الجودة في لوحة التحكم تمنع الاختبارات الفاشلة لكنها لا تفحص التغطية، وصفحة Release gate (بوابة الإصدار) لا حقل فيها للتغطية. ضع الحد الأدنى في استدعاء API.
والاختبارات الفاشلة فحص منفصل: أي تشغيل اختبار مسجل فيه اختبار فاشل أو رمز خروج غير صفري يرفض الإصدار، أيا كانت التغطية. وقائمة الخيارات كاملة في صفحة API، وطريقة تشغيل الاختبارات في صفحة الاختبار.
مصطلحات ذات صلة
- بوابة الجودة: الفحوص التي ينضم إليها الحد الأدنى للتغطية.
- سياسة التراخيص: خيار آخر في فحص CI نفسه.
- بوابة النشر: فحوص الإصدار لكل بيئة.
الأسئلة الشائعة
هل يرفض AI CodeOps التغيير حين لا يبلغ عن أي تغطية؟
نعم، حين تضع حدا أدنى. فإذا ضبطت minCoveragePct، يجب أن يبلغه أحدث تشغيل اختبار أبلغ عن التغطية. وإذا لم يبلغ أي تشغيل عن التغطية، يرفض الفحص، لأنه لا يمكن التحقق من الحد الأدنى.
هل الحد الأدنى للتغطية مفعل افتراضيا؟
لا. لا يسري إلا حين يمرر CI لديك القيمة minCoveragePct إلى فحص الإصدار. أما البوابة الخاصة بكل جلسة في لوحة التحكم فلا تفحص التغطية.
أي رقم للتغطية يستخدم AI CodeOps؟
رقم التغطية الإجمالي، مقروءا من مخرجات الاختبار حين تتضمن ملخصا، مثل سطر TOTAL من pytest-cov أو صف All files من Istanbul (عمود التعليمات فيه).