Java، C#، Python، Go… — QATrax دون Node.js
إنتاج قائمة SBOM وتقرير الاختبارات بأدوات لغتك، ثم إيداعهما كأي عميل.
المؤلف: Dr Hamid MADANI <drmdh@msn.com>
لا يقرأ QATrax شيفرتك. بل يقرأ ملفين قياسيين تعرف كل اللغات كيف تنتجهما:
- قائمة SBOM لإصدارك: CycloneDX أو SPDX، بصيغة JSON؛
- تقرير اختباراتك، كما تكتبه أداتك: JUnit XML (الأكثر انتشارًا)، NUnit، TRX، TestNG، Robot Framework، CTest، Cucumber JSON، Behave JSON، Allure 2، CTRF أو TAP.
لا تغيّر أداتك ولا صيغتك: إنها أيضًا الصيغ التي تقرؤها Xray وTestRail وAllure TestOps وAzure DevOps.
بقية الطريق واحدة للجميع: باختصار. تُوضع متطلباتك وخطة اختباراتك مرة واحدة، كما لأي عميل: تبويبا المتطلبات وخطة التطوير والاختبار.
1. سمِّ اختباراتك وفق خطتك
يحمل كل اختبار، في بداية اسمه، مرجعه في خطتك (T-MOD-01). ترفض اللغات الشرطة في اسم الدالة؛ اكتبه بـ _: فهو يُتعرَّف عليه. في BDD (Cucumber، Behave)، ومع Robot Framework أو Allure، يكفي وسم مساوٍ للمرجع (@T-MOD-01).
| اللغة | اسم الاختبار |
|---|---|
| Java (JUnit) | void test_T_MOD_01_aucune_vulnerabilite() |
| C# (xUnit, NUnit, MSTest) | public void test_T_MOD_01_aucune_vulnerabilite() |
| Python (pytest) | def test_T_MOD_01_aucune_vulnerabilite(): |
| Go | func Test_T_MOD_01_aucune_vulnerabilite(t *testing.T) |
| C++ (CTest) | add_test(NAME T_MOD_01_aucune_vulnerabilite COMMAND …) |
| Robot Framework | T-MOD-01 Aucune vulnérabilité (أو الوسم [Tags] T-MOD-01) |
| Cucumber، Behave | @T-MOD-01 فوق السيناريو |
تفاصيل الصيغة: صيغة النتائج.
2. إنتاج SBOM والتقرير
أداة لكل اللغات: Syft تقرأ مجلدك وتنتج قائمة SBOM.
syft dir:. -o cyclonedx-json=sbom.cyclonedx.json
يمكنك أيضًا استعمال أداة CycloneDX الخاصة بلغتك:
| اللغة | SBOM (CycloneDX JSON) | تقرير الاختبارات (كما هو) | |
|---|---|---|---|
| Java — Maven | mvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom ← target/bom.json | mvn test ← target/surefire-reports/TEST-*.xml | |
| Java — Gradle | الإضافة org.cyclonedx.bom، ثم ./gradlew cyclonedxBom ← build/reports/ | ./gradlew test ← build/test-results/test/TEST-*.xml | |
| C# — .NET | الأداة CycloneDX (dotnet tool install --global CycloneDX)، أو Syft | dotnet test --logger trx ← TestResults/*.trx (TRX)، أو TestResult.xml من NUnit، أو JUnit من JunitXml.TestLogger | |
| Python | pip install cyclonedx-bom، ثم cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.json | pytest --junitxml=resultats.xml | |
| Java — TestNG | كما في Maven أو Gradle | testng-results.xml (أصلي) | |
| Go | Syft | `go test -v ./... 2>&1 \ | go-junit-report > resultats.xml` |
| C، C++ — CMake | Syft | ctest -T Test ← Testing/<date>/Test.xml (أو ctest --output-junit resultats.xml) | |
| Robot Framework | Syft (أو أداة CycloneDX الخاصة بـ Python) | robot … ← output.xml | |
| BDD — Cucumber، Behave | أداة اللغة | --format json:cucumber.json؛ behave -f json -o behave.json | |
| Allure (أي لغة) | أداة اللغة | allure-results/: jq -s . allure-results/*-result.json > allure.json لإيداع واحد | |
| غير ذلك | Syft، أو trivy fs --format cyclonedx --output sbom.cyclonedx.json . | أي أداة تكتب إحدى هذه الصيغ، أو JUnit XML أو TAP |
3. إيداع الملفين
عبر الواجهة. تبويب المسار: أودع قائمة SBOM في الخطوة ③، ثم التقرير في الخطوة ② (أو في تبويب التنفيذات). يُربط التقرير بالإصدار المختار في أعلى الصفحة.
عبر نظام CI لديك. أنشئ مفتاحًا في تبويب المشاريع، عمود مفاتيح CI، ثم أرسل الملفين بـ curl. حدّد الإصدار (version=) في الإرسالين كليهما: فهو الذي يرتّب اختباراتك في ملف هذا الإصدار.
V=1.4.0 # la version que vous livrez
curl -fsS -X POST "$QATRAX_URL/sbom?p=$QATRAX_PROJET&version=$V" \
-H "Authorization: Bearer $QATRAX_CLE" -H "content-type: application/json" \
--data-binary @sbom.cyclonedx.json
curl -fsS -X POST "$QATRAX_URL/runs?p=$QATRAX_PROJET&version=$V&format=json" \
-H "Authorization: Bearer $QATRAX_CLE" -H "content-type: application/xml" \
--data-binary @resultats.xml
لا تهمّ قيمة content-type كثيرًا: تُتعرَّف الصيغة من المحتوى (.trx، output.xml، Test.xml، cucumber.json… تُرسل بالطريقة نفسها). إن كانت لديك عدة ملفات تقارير (ملف لكل صنف اختبار في Maven وGradle، وملف لكل اختبار في Allure)، فأرسلها واحدًا تلو الآخر، أو اجمع نتائج Allure في مصفوفة واحدة.
يبيّن الرد الصيغة المقروءة، وعدد الاختبارات التي تُعرِّف عليها في خطتك، وتلك التي لم يُتعرَّف عليها.
3 مكرر. اختياري: تقرير التحقق المختوم، كما في Node.js
إن كان نظام CI لديك يتضمن Node.js (الإصدار 18 أو أحدث، الموجود في معظم الصور)، يستطيع @mostajs/mjs-unit قراءة تقرير أداتك. لا يعيد تشغيل أي اختبار. بل يصنع منه تقرير التحقق المختوم، المرتبط بقائمة SBOM وبخطتك، ويرسله مع الخطة وSBOM. لا تحتاج إلى كتابة أي شيفرة JavaScript.
# Java (Maven) : les rapports Surefire ; .NET : TestResults (les .trx) ; Robot : output.xml ; Allure : allure-results
export MJS_DEPUIS=target/surefire-reports MJS_SBOM=target/bom.json MJS_PLAN=plan.json
export QATRAX_URL=… QATRAX_CLE=… QATRAX_PROJET=…
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=3 # lit les rapports, écrit le compte rendu scellé
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=4 # envoie le plan, la SBOM, puis le compte rendu
مع تقرير التحقق، يجري qatrax تحققين إضافيين: أن التقرير لم يُعدَّل بعد قراءته، وأن قائمة SBOM المودعة هي فعلًا التي اختُبرت.
4. الإصدار
إنها النهاية نفسها كما لأي عميل: تبويب SBOM/الثغرات، ابتّ في كل ثغرة؛ ثم تبويب المُسلَّم ← أصدِر واختم.
ما يتغيّر مقارنةً بـ Node.js
الحكم والشهادة هما نفسهما. فرق واحد فقط: تقرير التحقق المختوم. إن أرسلت ملف JUnit أو TAP مباشرة (curl)، لا يجري qatrax التحققين الخاصين بتقرير التحقق. بل يجريهما إن مررت عبر mjs-unit في وضع القارئ (§ 3 مكرر).