Expand description
Command-line interface — a thin shell over the tzcompile library.
The CLI parses arguments, builds a CompileConfig, and calls the library. It holds no
compiler logic of its own; everything substantive lives in the library so it can be
reused and tested directly. Subcommands:
compile— compile selected zones to a TZif tree under--out;compare— compile a zone and diff it against referencezic(the oracle);explain— say what a zone would compile to, or why it is unsupported;supported-syntax— print the subset this version implements;support-report— map a whole source file: which identifiers compile, and why the rest don’t.
Structs§
- AuxTable
Validate Args aux-table-validate(T16.4): structural validation of auxiliary.tabfiles. Each flag points at a table file directly — they are not--inputcompile sources (the category law).- Cli
- Top-level CLI definition.
- Compare
Args - Compile
Args - Doctor
Args doctor(T16.6b): read-only environment probe.- Explain
Args - Release
Diff Args release-diff(T16.6a): diff two tzdb releases per identifier.- Semantic
Report Args semantic-report(T15.3): typedzdump-backed semantic witnesses for a compact zone set.- Size
Report Args - Structural
Report Args - Support
Report Args - Tzif
Validate Args tzif-validate(T15.4): RFC 9636 structural validation of zic-rs + reference TZif output.- Vendor
Oracle Admit Args vendor-oracle-admit(T16.5b): ingest + admit an external receipt JSON file.
Enums§
- Bloat
Arg - Reference
zic’s-b {slim|fat}bloat value (T10.2). This is the emission policy knob — whether otherwise-redundant transitions are kept (fat) or dropped (slim) — and is a thin alias ontoEmitStyleArg. It is not the TZif version (content-driven) and not the-Rredundant-tail range.zic’s own default isslim; zic-rs keeps a behaviour-matched fat-style default and only changes emission when asked. - Command
- Compare
Mode Arg --modevalue.- Emit
Style Arg --emit-stylevalue (T8-slim).- Link
Mode Arg --link-modevalue.- Report
Format Arg --formatvalue forsupport-report.- Unsupported
Arg --unsupportedvalue.
Functions§
- run
- Run the CLI. Returns
Ok(())on success; the caller mapsErrto a process exit code. - supported_
syntax_ text - The human-readable supported-syntax summary (also the source of truth for
docs/supported-syntax.md’s prose).