Cómo nombrar tus pruebas para Qably

Qably deriva los nombres de las pruebas y suites a partir de los identificadores emitidos por el ejecutor de pruebas y la estructura de archivos del repositorio. Los títulos definidos en el código se reflejan directamente en la plataforma, convirtiendo los nombres de las pruebas en documentación técnica accesible para todo el equipo.

Pautas para nombrar las pruebas

Las siguientes pautas de diseño ayudan a estructurar suites descriptivas y legibles:

1. Agrupe por funcionalidad de negocio en lugar de estructuras técnicas o clases internas. Los bloques descriptivos deben reflejar la acción del usuario (por ejemplo, "Carrito de compras" en lugar de "CartServiceImpl").
2. Redacte cada prueba combinando un verbo en presente y la condición esperada: "rechaza un token vacío", "acepta un token de hasta 500 caracteres".
3. Limite cada prueba a un comportamiento específico. Nombres que requieren conectores como "y" suelen indicar casos compuestos que conviene independizar.
4. Nombre el archivo según el módulo o funcionalidad que valida, ya que este nombre define el título de la suite en Qably.

Normalización automática de nombres

Durante la ingesta, Qably formatea identificadores técnicos en texto legible separando palabras en camelCase o snake_case y omitiendo prefijos comunes como "test", "spec", "prueba" o "caso". De este modo, un identificador como testTokenNull se registra en la plataforma como "Token null".

Si el nombre en el código ya está formulado como una oración (por ejemplo, "debe rechazar un token vacío"), Qably conserva la redacción intacta capitalizando únicamente la primera letra sin alterar el verbo ni recortar términos.

Nota: Qably no traduce el contenido de las pruebas. El identificador técnico actúa como clave de enlace entre el código fuente y el historial de ejecuciones. Si su equipo escribe pruebas en inglés pero opera la plataforma en español, las descripciones traducidas deben gestionarse en la documentación del caso, no en su identificador.

Un ejemplo antes y después

No es necesario renombrar pruebas existentes para comenzar a utilizar Qably. La plataforma importa los identificadores actuales y respeta cualquier ajuste manual posterior: si un miembro del equipo edita el título de un caso desde la consola, las importaciones subsecuentes preservan el valor modificado.