تشغيل الاختبارات

لكل مجموعة اختبارات هدف في make، والتكامل المستمر يستدعي الأهداف نفسها. شغّل make test قبل أن تدفع تغييراتك؛ فهو يشغّل مستوى اختبارات الوحدة للغة Go وبايثون وتطبيق الويب.

المستويات

لكل مستوى ميزانية زمنية، ولكل اختبار حدّ مرن (يُصدر تحذيرًا) وحدّ صارم يساوي ثلاثة أضعاف الحدّ المرن (يُفشل الاختبار). القواعد الكاملة في docs/testing.md.

Go

make test-unit-go          # every Go module, -short, under -race, with budgets
cd api && go test -short ./...           # one module, quickly
cd api && go test -short ./internal/handlers/...   # one area

• اختبارات الوحدة هي الافتراضية، وتُشغَّل عبر go test -short.
• تحمل اختبارات التكامل الوسم //go:build integration. الاختبارات التي تحتاج إلى PostgreSQL تقرأ MAKTABA_TEST_PG_URL، وتنشئ قاعدة بيانات مؤقتة خاصة بها وتُرحّلها ثم تحذفها.
• لمُرحِّل السحابة أهدافه الخاصة: make relay-test (وmake relay-ci للفحص الساكن والاختبار والبناء).

خط المعالجة (بايثون، عبر uv)

make test-unit-py                        # pytest -m unit
cd pipeline && uv run --extra dev pytest -m unit
cd pipeline && uv run --extra dev ruff check . && uv run --extra dev mypy

علّم الاختبارات بـ@pytest.mark.unit أو @pytest.mark.integration أو @pytest.mark.e2e. يشمل mypy --strict المجلد tests/ أيضًا، لذا تحتاج دوال الاختبار إلى تعليقات نوع الإرجاع (-> None). شغّل أوامر uv واحدًا تلو الآخر؛ فالتشغيل المتوازي قد يتسابق على البيئة الافتراضية.

الويب (vitest)

make test-unit-web                       # pnpm -C web run test:unit
cd web && pnpm install && pnpm test:unit
cd web && pnpm exec vitest related src/path/to/file.tsx   # tests for one file

يشغّل make lint-web كلًّا من eslint وtsc --noEmit وprettier. للحزم الموجودة في web/packages/ (مثل devportal) اختباراتها الخاصة.

التطبيقات الأصلية

• Apple: يشغّل swift test في apps/apple/MaktabaKit/ اختبارات الحزمة دون محاكٍ. ويشغّل xcodebuild test -scheme "Maktaba Player Mac" الاختبارات المستضافة لمشغّل Mac. تُشغَّل مخططات اختبارات الواجهة لأجهزة iPhone وiPad وMac في التكامل المستمر؛ وتجنّب تشغيل اختبارات الواجهة على جهاز مشترك، لأنها تستحوذ على الشاشة.
• Android: من داخل apps/android/:

./gradlew :client:test
./gradlew :core:testDebugUnitTest
./gradlew :player:testDebugUnitTest :remote:testDebugUnitTest
./gradlew :player:verifyRoborazziDebug   # screenshot tests against references

• التلفاز: يبني make tv-build-ios وmake tv-build-android تطبيقات التلفاز.
• رموز التصميم: يفشل make test-tokens إذا كان Tokens.swift أو Tokens.kt المولَّدان قديمين، أو إذا قلّ تباين نص عن 4.5:1.

بوابة الاختبارات المتأثرة

أي دفع يغيّر شيفرة تطبيق أو خدمة يجب أن يغيّر أيضًا الاختبارات التي تغطيها. تفرض الأداة tools/affected-tests ذلك في خطّاف ما قبل الدفع وفي التكامل المستمر.

ثبّت الخطّاف مرة واحدة لكل نسخة من المستودع:

tools/affected-tests/install-hook.sh

عند git push يقارن الخطّاف فرعك بـorigin/main، ويطبع الاختبارات المتأثرة مصنّفة حسب المنصة، ويمنع الدفع في الحالتين التاليتين:

• ملف مصدري تغيّر دون أن يتغيّر أيٌّ من اختباراته، أو
• اختبار ما زال يستخدم نصًّا أو معرّف إتاحة لم يعد موجودًا في أي مصدر (فالاختبار قديم وسيفشل).

يحتاج تغيير الواجهة إلى تغيير في الاختبارات على كل منصة تستخدم اختباراتها المعرّف أو النص الذي مسّه التغيير. وحين تنجح البوابة، يشغّل الخطّاف الاختبارات المتأثرة الآمنة محليًّا (Go مع -short، وبايثون، وvitest، واختبارات Android على JVM، وMaktabaKit). أما أهداف اختبارات واجهة Apple فتُترجَم فقط؛ ولا يُشغَّل أي محاكٍ من الخطّاف.

يجد الخطّاف اختبارات أي ملف من خريطة تغطية ينشرها التكامل المستمر على main، ومن بحث في معرّفات الواجهة ونصوصها (يُحلّ عبر جداول النصوص)، ومن أعراف التسمية (foo.go إلى foo_test.go، وfoo.ts إلى foo.test.ts، وFoo.kt إلى FooTest.kt).

الخيارات:

• إذا كان عدم تغيير الاختبارات صحيحًا: أضف No-Test-Change: <why> تذييلًا لأي إيداع (commit) ضمن الدفع.
• للبوابة فقط دون تشغيل أي اختبار: AFFECTED_TESTS_NO_RUN=1 git push.
• للاستعلام دون دفع: cd tools/affected-tests && go run . list (أو gate أو check؛ مع --range a...b و--json).
• يتخطى git push --no-verify الخطّاف، لكن مهمة affected-tests في التكامل المستمر تطبّق البوابة نفسها على طلب الدمج.

الاختبار الذي يفشل بعد تغييرك اختبار قديم يجب إصلاحه في التغيير نفسه، وليس فشلًا عشوائيًّا.

اعرض مصدر هذه الصفحة على GitHub