zpl_toolchain_cli 0.1.1

Command-line interface for parsing, validating, and formatting ZPL II label code
zpl_toolchain_cli-0.1.1 is not a library.

cli

zpl command-line interface for parsing, syntax-checking, linting, and formatting ZPL.

Commands

zpl parse <file.zpl>
zpl syntax-check <file.zpl>
zpl lint <file.zpl> [--profile profiles/zebra-generic-203.json]
zpl format <file.zpl> [--write] [--check] [--indent none|label|field]
zpl coverage --coverage generated/coverage.json [--show-issues | --json]
zpl explain <DIAGNOSTIC_ID>

Options

  • --tables: path to parser_tables.json (optional — tables are embedded at compile time by default).
  • --profile: optional printer profile JSON for contextual checks (e.g., ^PW, ^LL).
  • --output pretty|json: force output mode (default: auto-detect TTY).

Behavior notes

  • syntax-check: Returns ok: true in JSON output unless there are Error-severity diagnostics. Warnings and info do not affect the ok flag.
  • --tables: When an explicit path is provided and the file cannot be read or parsed, the CLI reports the error and exits with code 1 (it does not silently fall back to embedded tables).

Format command

  • Default: prints formatted ZPL to stdout.
  • --write (-w): overwrites the file in-place (only if content changed).
  • --check: exits with code 1 if the file is not already formatted (for CI).
  • --indent: indentation style — none (flat, default), label (2-space inside ^XA/^XZ), or field (label + 2-space inside ^FO…^FS).