testform graph

testform [opciones globales] graph [opciones]

El comando testform graph genera una representación visual del grafo de dependencias de toda tu infraestructura de pruebas. Soporta múltiples formatos de salida, incluyendo el estándar DOT (Graphviz), diagramas nativos de Mermaid y una vista en árbol para la terminal (Console / Tree).

---

Opciones Disponibles

Opción	Descripción
-format=FORMAT	Formato de salida del grafo. Valores admitidos: dot (por defecto), mermaid, console, tree, string.
-draw-cycles	Resalta cualquier ciclo de dependencia detectado con aristas rojas para diagnóstico.
-type=TYPE	Tipo de operación a graficar: plan, plan-refresh-only, plan-destroy o apply.
-plan=tfplan	Renderiza el grafo a partir de un archivo de plan previamente guardado. Implica -type=apply.
-scope=SCOPE	Filtra el grafo por ámbito (testcase, testrun, testplan).

---

Formatos de Salida

1. Formato DOT (Graphviz por defecto)

Ideal para renderizar en imágenes SVG/PNG con herramientas como Graphviz:

$ testform graph -format=dot

digraph G {
  rankdir = "RL";
  node [shape = rect, fontname = "sans-serif"];
  "testcase.login_valid" -> "testrun.sprint_42";
  "testcase.checkout_coupon" -> "testrun.sprint_42";
  "testrun.sprint_42" -> "testplan.release_2_0";
}

# Exportar directamente a SVG:
testform graph | dot -Tsvg -o dependencies.svg

2. Formato Mermaid (-format=mermaid)

Ideal para incrustar diagramas en documentación técnica, Pull Requests o archivos Markdown:

$ testform graph -format=mermaid

graph TD
  subgraph testplan["Plan de Certificación"]
    TP1["Release 2.0 (@tp-1)"]
  end
  subgraph testrun["Ejecuciones"]
    TR1["Sprint 42 (@tr-1)"]
  end
  subgraph testcase["Casos de Prueba"]
    TC1["Validar Login (@tc-1)"]
    TC2["Checkout con Cupón (@tc-2)"]
  end

  TR1 --> TP1
  TC1 --> TR1
  TC2 --> TR1

3. Formato Consola / Árbol (-format=console o -format=tree)

Muestra la jerarquía de dependencias en un árbol ASCII legible directamente en tu terminal:

$ testform graph -format=console

testplan: Release v2.0 (@tp-1)
└── testrun: Sprint 42 (@tr-1)
    ├── testcase: Validar Login (@tc-1)
    └── testcase: Checkout con Cupón (@tc-2)

---

Detección de Dependencias Cíclicas (-draw-cycles)

Si dos o más pruebas tienen dependencias circulares (por ejemplo, el escenario A depende de B y B depende de A), el flag -draw-cycles utiliza un algoritmo de búsqueda en profundidad (DFS) para resaltar las aristas que causan el ciclo en color rojo:

$ testform graph -draw-cycles -format=dot

digraph G {
  "testcase.A" -> "testcase.B";
  "testcase.B" -> "testcase.A" [color = "red", penwidth = 2.0];
}

---

Códigos de Salida

• 0: Grafo generado exitosamente.
• 1: Error al procesar los archivos de pruebas o sintaxis inválida.