Skip to content
Beta · version 0.7.1 · commands and the JSON format may still change.

CLI: tabalyst generate

tabalyst generate validates a Generate package and writes synthetic CSV data. The command exists since Tabalyst 0.6.2; packages, --example computer and the options marked Computer need 0.7.0 or later. See Tabalyst Generate for a walkthrough.

tabalyst generate PACKAGE (-o FILE.csv | -d DIR) [options]
tabalyst generate --example NAME (-o FILE.csv | -d DIR) [options]
tabalyst generate (PACKAGE | --example NAME) --validate-only

Provide exactly one source: a package directory or its dataset.yaml, or --example crm, --example insurance or --example computer. Exactly one destination is required, except with --validate-only. A definition_version: 1 YAML file stops the command with PACKAGE_FORMAT.

OptionMeaning
--example NAMEUse the packaged crm, insurance or computer example.
-o, --output FILEWrite one clean CSV.
-d, --output-dir DIRWrite all planned artifacts to a directory.
--rows NOverride the generated row count; for insurance, allocate the combined total across its branches.
--seed INTEGEROverride the root random seed.
--as-of-date YYYY-MM-DDOverride the reference date.
--anomaly-profile NAMEProduce the selected anomaly variant, cell change log and summary. Requires -d.
--request FILERead rows, seed, as_of_date, generation_profile, output_profile, market, locales, unit_style, unit_columns and anomaly_profile from a JSON object. Explicit options win.
--generation-profile NAMEComputer: bias the catalog selection.
--output-profile NAMEComputer: choose the columns written (compact, standard, extended).
--market ca|usComputer: the offer market.
--locales en,frComputer: the languages written.
--unit-style numeric|localizedComputer: plain numbers or values with units.
--unit-columns A,BComputer: the measurement columns to write with units; implies localized.
--validate-onlyValidate the package and write nothing.
-f, --forceReplace existing generated artifacts.

Explicit options override package defaults. Paths are checked before generation; the package and packaged resources cannot be overwritten. A selected anomaly profile keeps the clean CSV alongside its altered variant.