Cómo ejecutan los tests los candidatos en una prueba de código
Los candidatos ejecutan los tests del propio proyecto desde la pestaña Tests o la terminal. Imprime TAP desde el comando de tests para obtener una fila por test.
Los candidatos ejecutan ellos mismos los tests del proyecto, tantas veces como quieran, desde la pestaña Tests del editor o desde la terminal. La pestaña Tests ejecuta el comando de tests de tu kendor.yaml y muestra el resultado. Si ese comando imprime TAP, cada test tiene su propia fila.
Dónde están los tests
Los tests son archivos normales del proyecto. Ponlos donde tu ejecutor de tests los espere, como tests/, src/__tests__/ o junto al código. Los candidatos siempre pueden abrirlos y leerlos, también en los retos de archivo único.
Los candidatos lo saben antes de empezar: la página de inicio les dice que pueden ejecutar los tests del proyecto desde la pestaña Tests o desde la terminal cuando quieran.
Evita que los candidatos cambien tus tests
Indica tus tests como rutas de solo lectura: en el editor de la prueba, elige Configuración y rellena Rutas de solo lectura, separadas por comas. Una entrada puede ser un archivo (phpunit.xml), una carpeta (tests/) o un prefijo que termina en * (src/test*).
- Los archivos de solo lectura se abren bloqueados en el editor del candidato.
- Si un candidato cambia uno de todos modos, desde la terminal o mediante un agente de IA, Kendor vuelve a poner tu original antes de cada ejecución de tests.
- Cada guardado también conserva tu original, así que el código que revisas siempre tiene tus tests.
Sin rutas de solo lectura, los candidatos pueden cambiar los tests como cualquier otro archivo.
Qué se ejecuta cuando un candidato elige Ejecutar tests
La pestaña Tests está en la barra izquierda del editor, tras el icono del matraz. Al elegir Ejecutar tests se ejecuta el test.command de un servicio de tu kendor.yaml:
- el servicio indicado en
kendor.gradeService, si lo definiste - si no, el servicio de
preview.service - si no, el único servicio, si solo hay uno
version: 1
runtime:
type: python
version: "3.12"
services:
app:
dev:
command: uvicorn main:app --host $HOST --port $PORT --reload
port: 8000
test:
command: pytest --tap-stream
preview:
service: appEl comando se ejecuta dentro del propio sandbox del candidato, sobre sus archivos actuales, con las dependencias ya instaladas. Se ejecuta desde la raíz del proyecto, o desde el workDir del servicio si lo tiene. También puedes definir el comando en el formulario de configuración de runtime del editor de la prueba, en el campo Comando de prueba (opcional), que escribe el mismo kendor.yaml.
Los candidatos pueden cambiar parte de kendor.yaml en su propia sesión, como los servicios y los pasos de instalación, pero no el comando de tests. Kendor siempre ejecuta el que tú definiste.
Nota. Sin comando de tests, Ejecutar tests muestra un error que pide un test.command en kendor.yaml. Compruébalo una vez con Vista previa como candidato antes de lanzar.
Varios servicios
Para un proyecto con más de un servicio, como una API y un worker, enuméralos en kendor.gradeServices. El comando de tests de cada servicio se ejecuta en su propia carpeta, y las filas se combinan, cada una con el nombre del servicio como prefijo: api › creates a user. Consulta Aplicaciones con varios servicios.
Qué ven los candidatos
Tras una ejecución, la pestaña muestra un resumen como 7/9 passed (78%) y una fila por test con su duración. Los tests que fallan se abren automáticamente para mostrar el mensaje de error. El botón de actualizar del resumen vuelve a ejecutar la suite.
Si el comando no imprimió TAP, hay una única fila llamada test suite. Pasa cuando el comando termina con código 0 y falla en caso contrario. Los candidatos pueden ejecutar el comando en la terminal para ver su salida completa.
Si Kendor no puede ejecutar la suite en absoluto, por ejemplo porque no hay comando de tests, la pestaña muestra el error en lugar de las filas.
Obtén una fila por test con TAP
Kendor lee TAP (líneas ok 1 - name / not ok 2 - name) de la salida estándar del comando. Todo lo que se imprime en la salida de error estándar se ignora al contar, de modo que el ruido de la compilación no puede añadir ni ocultar un test.
Estos comandos imprimen TAP en los sandboxes de Kendor:
pytest --tap-streamnode --testgo test -json ./... | kendor-gotest-tapcargo test --color never 2>&1 | kendor-cargo-taprm -rf target/surefire-reports; mvn -B -q test 1>&2; kendor-junit-tap 'target/surefire-reports/*.xml'./vendor/bin/phpunit --log-junit /tmp/kendor-phpunit.xml- Python: el Python de Kendor incluye
pytest-tap, así que--tap-streamfunciona sin añadir nada a tus requisitos. - Node.js:
node --testimprime TAP cuando no está conectado a una terminal, que es como lo ejecuta la pestaña Tests. - Go, Rust, Java y C++:
kendor-gotest-tap,kendor-cargo-tapykendor-junit-tapson conversores que se incluyen en todos los sandboxes.kendor-junit-taplee informes JUnit XML, así que también sirve para Gradle (build/test-results/test/*.xml) y para los ejecutores de tests de C++ que escriben JUnit XML. - PHP: cuando un único comando de tests en la raíz del proyecto hace que PHPUnit escriba su registro JUnit en
/tmp/kendor-phpunit.xml, Kendor lee cada test de ese registro.
Consejo. Envía la propia salida de Maven o Gradle a la salida de error estándar (1>&2) como arriba, para que solo el TAP llegue a la salida estándar.
Ejecutar los tests en la terminal
Los candidatos también pueden ejecutar el mismo comando, u otro cualquiera, en la terminal. La salida allí es la que imprime el ejecutor en una terminal, que en algunos ejecutores tiene un formato más cómodo que TAP. Ambos se ejecutan en el mismo sandbox sobre los mismos archivos.
Los revisores también pueden ejecutarlos
En la página de revisión de una entrega, Abrir en el editor abre el código del candidato en el editor completo con su propio sandbox. La pestaña Tests también funciona ahí, así que puedes ejecutar la suite sobre exactamente lo que entregó.
Si un candidato editó un archivo de tests que no es de solo lectura, la pestaña Solución lo marca como modificado y Diferencias vs inicial muestra lo que cambió. Consulta Revisa una entrega.