كيف يقوم go test بتشغيل جميع اختبارات المشروع: تحليل تحت الغطاء

كيفية تشغيل جميع الاختبارات في مشروع Go وماذا يحدث "تحت الغطاء"؟

كل مطور Go قام مرة واحدة على الأقل في حياته بكتابة الأمر السحري go test ./... في الطرفية وشاهد علامات الاختيار الخضراء تجري عبر الشاشة. ولكن هل تساءلت يومًا عما يحدث بالفعل في تلك اللحظة؟ لماذا يتم تشغيل الاختبارات بهذه الطريقة وليس بطريقة أخرى؟ ولماذا أحيانًا يتخطى go test بصمت اختباراتك الجديدة؟

في هذه المقالة، لن نجيب فقط على السؤال الشائع من Stack Overflow (حيث حصل على آلاف المشاهدات)، بل سنلقي نظرة تحت غطاء مترجم Go ونتعرف على كيفية عمل آلية الاختبار. هيا بنا!

لماذا go test ./... هو السحر؟

لنبدأ بالأساسيات. الأمر go test بدون وسائط يقوم بتشغيل الاختبارات فقط في الحزمة الحالية. ولكن إذا كان لديك مشروع من عشرات الحزم (وهذا هو الحال في الإنتاج الفعلي)، فإن تصفحها يدويًا يشبه التعذيب في العصور الوسطى. هنا يأتي دور ./....

هذا النمط يعني: "ابحث عن جميع الحزم بشكل تكراري، بدءًا من الدليل الحالي". يقوم Go باجتياز شجرة الدلائل، متجاهلاً vendor والوحدات النمطية، ويجمع قائمة بجميع الحزم. لكل منها، يقوم بتشغيل نسخة منفصلة من go test.

ولكن ماذا لو كنت تريد تشغيل الاختبارات فقط في أدلة معينة؟ على سبيل المثال، فقط في ./internal/...؟ يعمل بنفس الطريقة: go test ./internal/....

هام: إذا كنت تستخدم Go Modules (وهو المعيار منذ Go 1.16+)، فإن ./... يعمل فقط ضمن نطاق الوحدة النمطية الحالية. لاختبار جميع الوحدات النمطية في مساحة العمل، سيتعين عليك استخدام go test ./... في كل منها أو إعداد go.work.

وما هي "الحزمة" في سياق go test؟

يعمل Go بمفهوم الحزمة — مجموعة من ملفات .go في دليل واحد. ملفات الاختبار (باللاحقة _test.go) تعتبر أيضًا جزءًا من الحزمة، ولكن يتم تجميعها بشكل منفصل. عند تشغيل go test، يقوم Go بتجميع ملف ثنائي للاختبار يتضمن:

\n
• الكود المصدري للحزمة (ولكن فقط ما يتم استخدامه في الاختبارات)
\n
• كود الاختبارات نفسها
\n
• غلاف خاص لوقت التشغيل للتشغيل والتقرير
\n

يتم تشغيل هذا الملف الثنائي، وينفذ الاختبارات ويعرض النتيجة. العملية برمتها منفصلة لكل حزمة.

كيف يقرر Go أي الاختبارات يجب تشغيلها؟

عند كتابة go test ./...، يقوم Go بتنفيذ الخطوات التالية:

\n
1. اجتياز نظام الملفات — يجد Go جميع الدلائل التي تحتوي على ملفات .go.
\n
2. التصفية — يتم تجاهل دلائل vendor و testdata والمجلدات المخفية (التي تبدأ بـ .).
\n
3. التجميع — يتم إنشاء ملف ثنائي مؤقت لكل حزمة.
\n
4. التشغيل — يتم تنفيذ الملف الثنائي، ويتم جمع النتائج.
\n
5. التخزين المؤقت — إذا لم يتغير الكود، يستخدم Go ذاكرة التخزين المؤقت ويعرض (cached).
\n

النقطة الأخيرة هي سبب شائع للدهشة. لقد غيرت الاختبار، وتقوم بتشغيل go test ./...، فيقول "ok (cached)". لماذا؟ لأن Go يخزن النتائج مؤقتًا بناءً على تجزئة ملفات الإدخال. إذا قمت بتغيير تعليق فقط أو استيراد غير مستخدم، فإن التجزئة لا تتغير، ولا يتم إعادة تشغيل الاختبار.

نصيحة مفيدة: يمكنك إعادة تعيين ذاكرة التخزين المؤقت قسرًا باستخدام الأمر go clean -testcache. أو استخدم العلم -count=1 الذي يجبر Go على تجاهل ذاكرة التخزين المؤقت: go test -count=1 ./....

التوازي: لماذا الاختبارات ليست دائمًا أسرع؟

افتراضيًا، يقوم go test بتشغيل الاختبارات ضمن حزمة واحدة بشكل تسلسلي. ولكن بين الحزم — بالتوازي! يتم تحديد عدد الحزم المتزامنة بواسطة العلم -p (الافتراضي يساوي عدد وحدات المعالجة المركزية).

يبدو هذا رائعًا، ولكن هناك فارق بسيط: ه