تشغيل الاختبارات وتصفيتها

لتشغيل الاختبارات في ملف، تستدعي المصرّف في وضع الاختبار. يصرّف الأمر zig test كل كتلة اختبار يجدها وينفذها.

تمرّر إلى zig test ملف المصدر الجذري. فيستورد الاختبارات من ذلك الملف ومن أي ملف يصل إليه عبر @import.

بعد التشغيل، تطبع Zig عدد الاختبارات الناجحة. ويعني سطر مثل "All 7 tests passed" أن كل كتلة test عادت دون خطأ.

عند الفشل، تطبع Zig اسم الاختبار والتأكيد الذي فشل وتتبع المكدس. والـ name الذي اخترته هو ما يجعل قراءة ذلك سهلة.

شغّل الاختبارات التي تهمك فقط باستخدام --test-filter. ولا تُنفّذ إلا الاختبارات التي يحتوي اسمها على النص المحدد.

أثناء إصلاح ميزة ما، تعيد تشغيل اختباراتها فقط، فتصل إلى النتائج بسرعة. وتطابق الراية --test-filter جزءًا من اسم الاختبار.

أعِد الخطأ الخاص error.SkipZigTest من اختبار لوضع علامة «تم التخطي» عليه بدلًا من اعتباره فاشلًا، وهذا مفيد للحالات غير الجاهزة بعد.

يحصي الملخص الاختبارات المتخطاة منفصلةً عن الناجحة والفاشلة، لذلك لا يخفي skip مشكلة حقيقية في مجموعة اختباراتك.

في المشروع الفعلي، تُشغّل الاختبارات عادةً من خلال نظام البناء بدلًا من ذلك. فتعمل خطوة zig build test المهيّأة على تصريفها وتشغيلها.

يظل الملف الذي يحتوي على كتل test فقط ولا يحتوي على دالة main صالحًا مع zig test. إذ يوفر مشغّل الاختبارات نقطة الدخول نيابةً عنك.

بما أن تشغيل الاختبارات لا يتطلب سوى أمر واحد، يمكنك إجراؤه بعد كل تغيير. وتساعد النتائج السريعة على إبقاء قاعدة شيفرة Zig موثوقة.

لا تريد تشغيل إلا الاختبارات التي تذكر أسماؤها الكلمة parse. ما الأمر الذي يحقق ذلك؟

شغّلت الاختبارات باستخدام zig test، وقرأت الملخص، وصفّيت حسب الاسم، وتخطيت باستخدام error.SkipZigTest، وتعرّفت إلى zig build test. ✅