QATrax
عرض بصيغة Markdown

Java، C#، Python، Go… — QATrax دون Node.js

إنتاج قائمة SBOM وتقرير الاختبارات بأدوات لغتك، ثم إيداعهما كأي عميل.


المؤلف: Dr Hamid MADANI <drmdh@msn.com>

لا يقرأ QATrax شيفرتك. بل يقرأ ملفين قياسيين تعرف كل اللغات كيف تنتجهما:

لا تغيّر أداتك ولا صيغتك: إنها أيضًا الصيغ التي تقرؤها 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():
Gofunc Test_T_MOD_01_aucune_vulnerabilite(t *testing.T)
C++ (CTest)add_test(NAME T_MOD_01_aucune_vulnerabilite COMMAND …)
Robot FrameworkT-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 — Mavenmvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom ← target/bom.jsonmvn 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)، أو Syftdotnet test --logger trx ← TestResults/*.trx (TRX)، أو TestResult.xml من NUnit، أو JUnit من JunitXml.TestLogger
Pythonpip install cyclonedx-bom، ثم cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.jsonpytest --junitxml=resultats.xml
Java — TestNGكما في Maven أو Gradletestng-results.xml (أصلي)
GoSyft`go test -v ./... 2>&1 \go-junit-report > resultats.xml`
C، C++ — CMakeSyftctest -T Test ← Testing/<date>/Test.xml (أو ctest --output-junit resultats.xml)
Robot FrameworkSyft (أو أداة 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 مكرر).