Resumen de la CLI

La interfaz de línea de comandos (CLI) de Testform es la herramienta operativa central para gestionar tu infraestructura de pruebas como código. Diseñada bajo las convenciones y la filosofía de HashiCorp Terraform, ofrece un flujo de trabajo intuitivo, predecible y consistente.

Sintaxis de Comandos

testform [opciones globales] <subcomando> [opciones] [argumentos]

Opciones Globales

Las opciones globales pueden anteponerse a cualquier subcomando:

Opción Global	Alias	Descripción
-chdir=DIR	-C	Cambia el directorio de trabajo a DIR antes de ejecutar el comando.
-scope=SCOPE	-s	Limita la ejecución a testcase, testrun o testplan.
-project-id=ID	—	Sobrescribe el ID de GitHub Projects V2 configurado en main.yml.
-no-color	—	Desactiva los colores ANSI (ideal para servidores de logs continuos).
-json	—	Emite la salida estructurada en formato JSON para automatización y CI/CD.
-help	-h	Muestra la ayuda detallada y opciones para cualquier comando.
-version	-v	Imprime la versión instalada de Testform.

Scope-First Syntax

Testform permite anteponer el identificador de alcance antes del subcomando para facilitar una escritura más fluida:

# Sintaxis estándar:
testform plan -scope=testcase

# Sintaxis equivalente con scope al inicio:
testform testcase plan
testform testrun apply
testform testplan destroy

Directorios Operativos

Testform administra de forma automática el directorio local .testform/ para almacenar metadatos de backends, módulos descargados y extensiones, así como el directorio global ~/.testform.d/ para credenciales de acceso. Consulta El Directorio .testform y ~/.testform.d para más detalles.

---

Índice Completo de Comandos

Flujo de Trabajo Principal

Comandos para el ciclo de vida central de infraestructura de pruebas:

Comando	Descripción
testform init	Prepara el directorio de trabajo, descarga dependencias e inicializa el backend.
testform plan	Muestra los cambios requeridos por la configuración actual respecto al estado.
testform apply	Crea o actualiza recursos de prueba en los proveedores remotos.
testform refresh	Actualiza el estado local para reflejar los sistemas remotos.
testform destroy	Destruye los recursos gestionados previamente creados.

Herramientas de Desarrollador

Comandos de inspección, análisis, validación y reporte:

Comando	Descripción
testform validate	Comprueba de forma estática si la sintaxis y gobernanza son válidas.
testform fmt	Reformatea los archivos de configuración y .feature al estilo estándar.
testform diff	Muestra el desfase (drift) entre la configuración local y el estado.
testform show	Muestra el estado actual o un plan guardado en formato legible o JSON.
testform query	Consulta y filtra recursos gestionados en el estado mediante expresiones.
testform policy	Inspecciona, activa o desactiva políticas de calidad y gobernanza.
testform modules	Muestra todos los módulos declarados en el espacio de trabajo.
testform providers	Muestra el árbol de proveedores requeridos y esquemas de recursos.
testform functions	Inspecciona y evalúa funciones integradas de expresiones.
testform print	Analiza un archivo .feature e imprime su AST en formato JSON.
testform graph	Genera un grafo de dependencias en Graphviz (DOT), Mermaid o árbol.
testform report	Genera informes analíticos multidimensionales (Markdown, Word, Excel, JSON).
testform suite	Gestiona suites de pruebas y archivos de ejecución (init, -fill, -link, -mark).

Almacenamiento y Estado

Gestión avanzada del ledger de estado:

Comando	Descripción
testform state	Gestión avanzada del ledger de estado (list, show, mv, rm, pull, push).
testform output	Muestra valores de salida guardados en el estado o módulo raíz.
testform import	Asocia infraestructura existente con un recurso de Testform.
testform taint	Marca una instancia de recurso como degradada para forzar su reemplazo.
testform untaint	Remueve el estado de dañado de una instancia de recurso.
testform force-unlock	Libera manualmente un bloqueo abandonado en el workspace actual.

Espacios de Trabajo y Sesiones

Múltiples entornos, autenticación y versiones:

Comando	Descripción
testform workspace	Gestión de múltiples espacios de trabajo aislados (list, new, select, delete).
testform login	Obtiene y guarda credenciales de autenticación para un host remoto.
testform logout	Elimina credenciales de autenticación almacenadas localmente.
testform ephemeral	Gestiona sandboxes temporales de prueba en pipelines CI/CD.
testform version	Muestra la versión actual de Testform y comprueba actualizaciones.