QATrax
Ver en Markdown

Java, C#, Python, Go… — QATrax sin Node.js

Producir su SBOM y su informe de pruebas con las herramientas de su lenguaje y cargarlos como cualquier cliente.


Autor: Dr Hamid MADANI <drmdh@msn.com>

QATrax no lee su código. Lee dos archivos estándar que todos los lenguajes saben producir:

No cambia de herramienta ni de formato: son también los que leen Xray, TestRail, Allure TestOps o Azure DevOps.

El resto del camino es el mismo para todos: En resumen. Sus requisitos y su plan de pruebas se establecen una sola vez, como para cualquier cliente: pestañas Requisitos y Plan Dev+Test.

1. Nombrar sus pruebas según su plan

Cada prueba lleva, al principio de su nombre, su referencia en su plan (T-MOD-01). Los lenguajes no admiten el guion en el nombre de una función; escríbala con _: se reconoce. En BDD (Cucumber, Behave), con Robot Framework o Allure, basta una etiqueta igual a la referencia (@T-MOD-01).

LenguajeNombre de la prueba
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é (o la etiqueta [Tags] T-MOD-01)
Cucumber, Behave@T-MOD-01 encima del escenario

Detalle del formato: Formato de los resultados.

2. Producir la SBOM y el informe

Una herramienta para todos los lenguajes: Syft lee su carpeta y produce la SBOM.

syft dir:. -o cyclonedx-json=sbom.cyclonedx.json

También puede usar la herramienta CycloneDX de su lenguaje:

LenguajeSBOM (CycloneDX JSON)Informe de pruebas (tal cual)
Java — Mavenmvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.jsonmvn test → target/surefire-reports/TEST-*.xml
Java — Gradlecomplemento org.cyclonedx.bom, después ./gradlew cyclonedxBom → build/reports/./gradlew test → build/test-results/test/TEST-*.xml
C# — .NETla herramienta CycloneDX (dotnet tool install --global CycloneDX), o Syftdotnet test --logger trx → TestResults/*.trx (TRX), o TestResult.xml de NUnit, o el JUnit de JunitXml.TestLogger
Pythonpip install cyclonedx-bom, después cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.jsonpytest --junitxml=resultats.xml
Java — TestNGcomo Maven o Gradletestng-results.xml (nativo)
GoSyft`go test -v ./... 2>&1 \go-junit-report > resultats.xml`
C, C++ — CMakeSyftctest -T Test → Testing/<date>/Test.xml (o ctest --output-junit resultats.xml)
Robot FrameworkSyft (o la herramienta CycloneDX de Python)robot … → output.xml
BDD — Cucumber, Behavela herramienta del lenguaje--format json:cucumber.json ; behave -f json -o behave.json
Allure (cualquier lenguaje)la herramienta del lenguajeallure-results/ : jq -s . allure-results/*-result.json > allure.json para una sola carga
OtroSyft, o trivy fs --format cyclonedx --output sbom.cyclonedx.json .cualquier herramienta que escriba uno de estos formatos, JUnit XML o TAP

3. Cargar los dos archivos

Por la interfaz. Pestaña Recorrido: cargue la SBOM en el paso ③ y después el informe en el paso ② (o en la pestaña Ejecuciones). El informe se vincula a la versión elegida en la parte superior de la página.

Por su CI. Cree una clave en la pestaña Proyectos, columna Claves de CI, y envíe los dos archivos con curl. Indique la versión (version=) en los dos envíos: es ella la que coloca sus pruebas en el expediente de esa versión.

V=1.4.0   # la versión que entrega
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

El content-type importa poco: el formato se reconoce por el contenido (.trx, output.xml, Test.xml, cucumber.json… se envían de la misma manera). Si tiene varios archivos de informe (uno por clase de prueba en Maven y Gradle, uno por prueba en Allure), envíelos uno a uno, o reúna los resultados de Allure en una matriz.

La respuesta indica el formato leído, el número de pruebas reconocidas en su plan y las que no lo han sido.

3 bis. Opcional: el informe de validación sellado, como en Node.js

Si su CI tiene Node.js (versión 18 o superior, presente en la mayoría de las imágenes), @mostajs/mjs-unit puede leer el informe de su herramienta. No vuelve a lanzar ninguna prueba. Elabora con él el informe de validación sellado, vinculado a su SBOM y a su plan, y lo envía con el plan y la SBOM. No tiene que escribir nada de JavaScript.

# Java (Maven): los informes Surefire; .NET: TestResults (los .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   # lee los informes, escribe el informe de validación sellado
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=4   # envía el plan, la SBOM y después el informe de validación

Con el informe de validación, qatrax hace dos verificaciones más: el informe de pruebas no se ha retocado después de su lectura, y la SBOM probada es efectivamente la que se cargó.

4. Emitir

Es el mismo final que para cualquier cliente: pestaña SBOM/Vulnerabilidades, resuelva cada una; después, pestaña Entregable → Emitir y sellar.

Lo que cambia respecto a Node.js

El veredicto y el certificado son los mismos. Una sola diferencia: el informe de validación sellado. Si envía su JUnit o su TAP directamente (curl), qatrax no hace las dos verificaciones del informe de validación. Las hace si pasa por mjs-unit en modo lector (§ 3 bis).