Herramienta de línea de comandos

larrygram-cli · 1.0.0-alpha.1 (sin publicar)

larrygram-cli lee dibujos de Visio e imprime un resumen, renderiza una página o exporta todas las páginas como PNG o SVG. Funciona a través del mismo registro de comandos que la aplicación (file.inspect, file.render, file.export), así que un script ve el mismo comportamiento que una persona.

Solo la salida de inspect y --help van a la salida estándar. Los errores y las advertencias van a la salida de error estándar, una línea cada uno.

Uso

larrygram-cli - inspect, render and export Visio drawings

Usage:
  larrygram-cli inspect <file> [--json] [--page N]
  larrygram-cli render <file> --out <path> [--page N] [--format png|svg]
    [--scale PPI] [--background #RRGGBB|none] [--strict]
  larrygram-cli export <file> --out <dir> [--format png|svg] [--scale PPI]
    [--strict]
  larrygram-cli --help

Compílala desde el repositorio con:

cargo build --release -p larrygram-cli
./target/release/larrygram-cli --help

inspect

Resume un documento: su tipo, páginas, patrones, estilos y temas.

Opción	Significado	Predeterminado
--json	Imprime el resumen como un único objeto JSON	texto
--page N	Resume una página, contando desde 1	todas las páginas

larrygram-cli inspect flowchart.vsdx

kind: drawing
pages: 2
  1: Page-1 8.5 x 11 in, 3 shapes, 0 warnings
  2: (unnamed) 11 x 8.5 in, 0 shapes, 2 warnings
masters: 1
styles: 4
themes: 1
warnings: 2

Con --json, las claves son estables:

{
  "kind": "drawing",
  "masters": 1,
  "pages": [
    { "height": 11.0, "index": 1, "name": "Page-1", "shapes": 3, "warnings": 0, "width": 8.5 },
    { "height": 8.5, "index": 2, "name": "", "shapes": 0, "warnings": 2, "width": 11.0 }
  ],
  "styles": 4,
  "themes": 1,
  "warnings": 2
}

kind es drawing, stencil o template. Los tamaños de página están en pulgadas. Un tamaño que no se puede calcular es 0.

render

Renderiza una página en un archivo PNG o SVG.

Opción	Significado	Predeterminado
--out PATH	El archivo de salida (obligatorio)	—
--page N	La página que se renderiza, contando desde 1	la primera página
--format png|svg	El formato de salida	según la extensión de --out
--scale PPI	Escala del dispositivo en píxeles por pulgada; un número positivo	96
--background C	#RRGGBB para un color opaco, o none para transparente	el fondo propio de la página
--strict	Sale con el código 4 si hubo advertencias (el archivo se escribe igualmente)	desactivado

larrygram-cli render flowchart.vsdx --out page-1.png --scale 192
larrygram-cli render flowchart.vsdx --out page-2.svg --page 2 --background none

export

Renderiza todas las páginas de un documento en un directorio. Los archivos se llaman page-1.png, page-2.png y así sucesivamente.

Opción	Significado	Predeterminado
--out DIR	El directorio de salida (obligatorio)	—
--format png|svg	El formato de salida	png
--scale PPI	Escala del dispositivo en píxeles por pulgada	96
--strict	Sale con el código 4 si hubo advertencias	desactivado

larrygram-cli export flowchart.vsdx --out pages/ --format svg

Códigos de salida

Código	Significado
0	Éxito
1	Error de uso (argumentos incorrectos)
2	Error de entrada: el archivo no existe, no se puede leer o no se puede analizar
3	Error de renderizado o de salida
4	Hubo advertencias y --strict está activado

En integración continua

Haz que un trabajo falle cuando un dibujo se renderice con advertencias:

for f in diagrams/*.vsdx; do
  larrygram-cli export "$f" --out "build/${f%.vsdx}" --format svg --strict || exit 1
done

Nota

La CLI lee .vsdx, .vssx y .vstx. Nunca escribe archivos de Visio y nunca modifica su entrada.

Captura de pantalla próximamente

Inspecciona un dibujo y renderiza una página desde la terminal.