Documentación de Allure Report
Allure Report es una herramienta de código abierto popular para visualizar los resultados de una ejecución de pruebas. Puedes añadirla a tu flujo de trabajo de pruebas con poca o ninguna configuración. Produce informes que se puede abrir en cualquier lugar y pueden ser leídos por cualquiera, sin necesidad de conocimientos técnicos profundos.
Como analista de QA, haz que el análisis de los resultados de tus pruebas sea más fácil y efectivo filtrando y ordenando los resultados de las pruebas según tus necesidades. Compara los resultados con ejecuciones anteriores. Encuentra pruebas inestables. Analiza cómo se distribuyen los defectos en los resultados de las pruebas con categorías de defectos.
Como desarrollador, visualiza mensajes de error, trazas de stack y otra información de depuración. Enriquece los resultados de tus pruebas dividiéndolos en pasos o adjuntando datos de tiempo de ejecución como capturas de pantalla, registros o cualquier otra cosa. Si una prueba se ejecutó varias veces, consulta los detalles de cada intento. Usa la herramienta de línea de tiempo para encontrar problemas de rendimiento y paralelización en las pruebas.
Como gerente, controla la calidad del proyecto o de características y suites de pruebas individuales. Utiliza herramientas de análisis visual para ver cómo cambia la calidad del proyecto con el tiempo. Los informes de prueba son fáciles de abrir, fáciles de leer y admiten múltiples idiomas.
Cómo Allure es diferente
A diferencia de las herramientas de informes específicas para los frameworks concretos, Allure Report admite múltiples idiomas y frameworks y te permite usar cualquier combinación de ellos. Por ejemplo, si necesitas ejecutar tus pruebas de backend y frontend por separado, aún puedes convertir todos los resultados en un único informe de prueba, obteniendo una mejor visión de lo que sucede en tu proyecto.
Al mismo tiempo, Allure Report tiene un ecosistema de integraciones para varios frameworks y bibliotecas. Estas integraciones mejoran los informes con algunos datos listos para usar y te proporcionan una API para agregar aún más datos. Verifica si tu framework o biblioteca favorita es compatible.
Allure Report trabaja con resultados de pruebas en la forma más simple pero flexible: archivos. No es necesario depender de un servidor de informes en línea durante la ejecución, de hecho, no es necesario enviar datos a través de la red en absoluto. Simplemente señala a Allure Report un directorio, y leerá los resultados de las pruebas desde allí.
Y finalmente, Allure Report es muy fácil de integrar. No tienes que cambiar tu flujo de trabajo de pruebas para empezar a usarlo. Una ejecución o varias, en línea o fuera de línea, en una máquina o en un clúster: cualquier configuración es compatible, y el formato de datos abierto te permite extender el flujo de trabajo si es necesario.
Comienza con Allure
El inicio más rápido: instala Allure Report, ejecuta tus pruebas de la misma manera que lo haces ahora, asegúrate de tener resultados en formatos compatibles, y luego ejecuta Allure Report para convertir esos resultados en un hermoso informe HTML.
¿Listo para más? Instala uno de los adaptadores de Allure, bibliotecas específicas del framework que recopilan aún más datos durante tus pruebas. Usa la API proporcionada por el adaptador para habilitar funciones avanzadas de Allure como pasos, adjuntos, jerarquías de pruebas y más.
¿Necesitas una visión más amplia? Considera usar Allure TestOps, nuestra oferta paga que te permite rastrear casos de prueba manuales y automatizados, agregar resultados de pruebas de una amplia gama de fuentes y analizarlos en múltiples lanzamientos y proyectos.
Controla tu flujo de datos
Un flujo de trabajo de pruebas con Allure Report consta de dos pasos, ambos pueden realizarse localmente, sin enviar nada a través de la red.
- Fase de recopilación: mientras las pruebas se ejecutan, el framework de pruebas escribe sus resultados en un archivo o directorio.
- Fase de visualización: la utilidad de línea de comandos de Allure Report lee los resultados de las pruebas y genera un informe HTML.
Una vez generado el informe HTML, puedes eliminar de manera segura los resultados de las pruebas, por ejemplo, como parte de un procedimiento de limpieza antes de la próxima ejecución de pruebas.
Allure reconoce resultados de pruebas en muchos formatos, incluyendo nuestro propio formato de datos. Su compatibilidad se puede agregar a muchos frameworkso populares usando adaptadores de Allure, y algunos frameworks incluso lo admiten de forma nativa. En este formato de datos, cada resultado de prueba se almacena como un archivo JSON separado con un nombre de archivo generado aleatoriamente.
El formato de datos de Allure y el flujo de datos basado en archivos son:
- Paralelizables: puedes ejecutar pruebas en múltiples nodos siempre que combines todos los resultados en un único directorio antes de la fase de visualización.
- Independientes del framework: el formato de datos independiente del framework es perfecto para proyectos que abarcan múltiples lenguajes de programación y marcos de pruebas.
- Tolerantes a fallos: puedes generar un informe basado en los resultados de pruebas que tengas, incluso si otras pruebas no escribieron sus archivos debido a un problema inesperado.
- Extensibles: puedes filtrar o modificar los resultados de las pruebas entre las dos fases, gracias al formato de datos bien documentado.
Consulta Cómo funciona para una visión más detallada del flujo típico de datos en Allure Report.
Organiza los informes a tu manera
Un informe de prueba creado por Allure no está bloqueado a un servicio específico: es solo un pequeño sitio web HTML estático.
Puedes abrir un informe en cualquier computadora usando la propia utilidad de Allure Report o incluso solo un navegador. Esto te brinda máxima flexibilidad para compartir o publicar el informe.
- Envía un informe como un archivo ZIP a tu colega que necesite verlo.
- Almacena los informes en tu servidor web, con enlaces a informes anteriores.
- Usa los plugins de integración para incrustar informes en la interfaz de tu herramienta de CI.
Para más información, consulta Cómo ver un informe.
El ecosistema de Allure
La utilidad de Allure Report en sí misma es parte de un ecosistema más amplio, respaldado tanto por Qameta Software como por la amplia comunidad.
El ecosistema incluye:
Adaptadores que habilitan la compatibilidad con el formato de datos de Allure en varios frameworks de prueba.
Se recomienda usar un adaptador de Allure para tu framework para habilitar más funciones, como pasos, adjuntos y jerarquías de pruebas.
Adaptadores de bibliotecas para registrar ciertos tipos de eventos durante la prueba, por ejemplo, solicitudes HTTP, consultas de bases de datos, aserciones, etc.
Integraciones con IDE para generar informes desde IDEs de JetBrains o Visual Studio Code.
Integraciones CI/CD para generar y publicar informes como parte de tu pipeline.
Allure TestOps — un reemplazo pago de Allure Report que gestiona resultados de pruebas en múltiples lanzamientos para un análisis aún más profundo.
La mayoría de las herramientas (con la excepción de Allure TestOps) son de código abierto bajo la licencia Apache 2.0.