Ejecutar y filtrar pruebas

Para ejecutar las pruebas de un archivo, debe llamar al compilador en modo de pruebas. La orden zig test compila y ejecuta cada bloque de prueba que encuentra.

Debe proporcionar a zig test el archivo fuente raíz. La orden incorpora las pruebas de ese archivo y de cualquier archivo al que se llegue mediante @import.

Después de una ejecución, Zig muestra cuántas pruebas se superaron. Una línea como "All 7 tests passed" significa que todos los bloques test terminaron sin errores.

Cuando falla una prueba, Zig muestra su nombre, la aserción que falló y un seguimiento de la pila. El name que eligió es lo que facilita la lectura.

Ejecute solo las pruebas que le interesen con --test-filter. Solo se ejecutan las pruebas cuyo nombre contiene el texto indicado.

Mientras corrige una funcionalidad, vuelve a ejecutar solo sus pruebas, por lo que recibe resultados rápidamente. La opción --test-filter busca una subcadena del nombre de la prueba.

Devuelva el valor especial error.SkipZigTest desde una prueba para marcarla como omitida en lugar de fallida. Esto resulta útil para casos que aún no están listos.

El resumen cuenta las pruebas omitidas por separado de las superadas y las fallidas, por lo que un skip nunca oculta un problema real de su conjunto de pruebas.

En un proyecto real, normalmente ejecutará las pruebas mediante el sistema de compilación. Un paso zig build test configurado las compila y las ejecuta.

Un archivo que solo contiene bloques test y no tiene una función main sigue funcionando con zig test. El ejecutor de pruebas proporciona el punto de entrada.

Como ejecutar las pruebas requiere una sola orden, puede hacerlo después de cada cambio. Los resultados rápidos son lo que mantiene fiable una base de código de Zig.

Solo quiere ejecutar las pruebas cuyos nombres mencionan la palabra parse. ¿Qué orden debe usar?

Ha ejecutado pruebas con zig test, leído el resumen, filtrado por nombre, omitido pruebas con error.SkipZigTest y aprendido sobre zig build test. ✅