testform validate

testform [opciones globales] validate [opciones]

El comando testform validate comprueba la sintaxis y coherencia de tus archivos de configuración (tanto los archivos .feature como main.yml). Valida que los pasos cumplan con la gramática de Gherkin, que los campos personalizados coincidan con los esquemas declarados y que no existan transgresiones de políticas.

La validación se realiza a nivel estrictamente local y no realiza peticiones a APIs remotas ni valida credenciales externas.

Opciones del Comando

Opción	Por Defecto	Descripción
-target=target	Ninguno	Valida únicamente un archivo .feature o recurso específico (ej. -target=tests/smoke.run.feature o -target="auth/login.case.feature.@tc-1").
-scope=scope	all	Limita el alcance de validación a un scope específico (testcase, testrun, testplan o all).
-json	false	Emite diagnósticos en formato de objeto JSON, idóneo para linters de CI y Checks de GitHub.
-no-tests	false	Omite la ejecución de las políticas de calidad registradas.
-test-directory=dir	tests	Directorio que contiene los archivos de prueba.
-query=texto	Ninguno	Filtra escenarios que coincidan con la búsqueda.
-no-color	false	Desactiva colores en la salida de consola.

Ejemplos de Ejecución Real

Validación Global (Todos los Scopes)

$ testform validate
Validating configuration...
Success! The configuration is valid.

  Scenarios: 8
  Scope:     all (testcase: 6, testrun: 1, testplan: 1)

Validación de un Scope Específico

$ testform validate -scope=testcase
Validating configuration...
Success! The configuration is valid.

  Scenarios: 6
  Scope:     testcase

Validación con Destino Específico (-target)

$ testform validate -target=tests/testrun/smoke.run.feature
Validating configuration...
Success! The configuration is valid.

  Scenarios: 1
  Scope:     testrun

Advertencias de Esquema (Warnings)

$ testform validate
╷
│ Warning: Undeclared field 'tipo_prueba'
│
│   in tests/cart.case.feature:
│ The field 'tipo_prueba' is used but not declared in main.yml schema.
╵
Success! The configuration is valid, but there were some warnings.

Fallo por Error Sintáctico o de Política

$ testform validate
╷
│ Error: Every scenario must have an identity tag matching the configured identity pattern.
│
│   in tests/login.case.feature:14
│ Add the identity tag (e.g. @tc-1) to each scenario.
╵
Error: The configuration contains errors.

Integración en Pre-Commit y Verificaciones de PR en CI/CD

Incorpora testform validate -json en tu flujo de trabajo de Pull Requests en GitHub Actions para prevenir el merge de sintaxis Gherkin defectuosa en las ramas principales:

- name: Validar Configuración Test-as-Code
  run: testform validate -json

Códigos de Salida

• 0: Configuración válida (pueden existir advertencias).
• 1: La configuración contiene errores de validación.