Parsea UN reporte JUnit XML y devuelve un resumen estructurado.

Usá esta herramienta cuando tengas la ruta a un archivo de resultados JUnit XML (lo que emiten pytest, Maven Surefire, Gradle, etc.) y quieras saber qué pasó en esa corrida: cuántos tests corrieron, cuáles fallaron y con qué mensaje, cuáles dieron error o se saltearon, y cuánto tardó cada suite. Para comparar varias corridas usá flakiness_report.

Args: path: ruta (absoluta o relativa al directorio del servidor) a un único archivo JUnit XML.

Returns: "totales" (tests, pasados, fallos, errores, salteados), "fallos" y "errores" (lista con test, classname, tipo y mensaje), "salteados" (con motivo), "suites" y "tiempo_segundos". Si el archivo no existe o el XML está malformado, la herramienta falla con un mensaje que explica el problema.

Clasifica tests como estables, flaky o rotos a partir de N corridas.

Usá esta herramienta cuando tengas VARIOS reportes JUnit de corridas sucesivas de la misma suite (por ejemplo, los artefactos de los últimos builds de CI) y quieras distinguir qué tests fallan siempre (rotos), qué tests fallan a veces (flaky) y cuáles nunca fallan (estables). Un test con menos de min_runs ejecuciones queda como "datos_insuficientes" en lugar de recibir una clasificación apurada.

Args: path_glob: patrón glob que matchea los reportes, por ejemplo "testdata/corridas/*.xml". El orden alfabético de los archivos se toma como orden cronológico. min_runs: mínimo de ejecuciones para clasificar un test (default 3).

Returns: "tests" (uno por test con corridas_presentes, ejecuciones, fallos, tasa_fallo y clasificacion, ordenados de peor a mejor tasa), "resumen" con los conteos por clasificación, y la lista de "archivos" analizados.

Decide pass/fail sobre reportes JUnit, con razones explícitas.

Usá esta herramienta cuando necesites una decisión accionable (por ejemplo, "¿se puede promover este build?") en vez de datos crudos. Con un solo archivo verifica los fallos de esa corrida; con un glob de varias corridas verifica además la proporción de tests flaky. La política de este gate es un ejemplo: los umbrales los define quien llama, y la decisión final sigue siendo de una persona.

Args: path: ruta a un reporte JUnit, o glob con varias corridas (por ejemplo "testdata/corridas/*.xml"). max_failures: máximo de tests fallidos (fallos + errores) tolerados en la última corrida (default 0). max_flaky_rate: proporción máxima de tests flaky sobre los tests clasificados, entre 0 y 1 (default 0.0; solo aplica con varias corridas). min_runs: mínimo de ejecuciones para clasificar un test (default 3).

Returns: "decision" ("pass" o "fail"), "aprobado" (bool), "razones" (lista de oraciones que explican cada verificación) y "verificaciones" (los valores medidos contra cada umbral).