@datoteca/cli

@datoteca/cli

Command-line interface for Datoteca — generate realistic, localized Chilean test data (RUT, people, addresses, phones, money, companies) from the terminal, no TypeScript/JavaScript required. Useful for populating fixtures, generating CSV/JSON for QA, or feeding non-JS stacks (Go, Python, etc.).

Every command wraps @datoteca/cl — same seeded determinism guarantee: same seed and flags, always the same output.

Installation

Run without installing:

npx @datoteca/cli person --seed 42 --count 3

Or install it globally:

npm install -g @datoteca/cli
datoteca person --seed 42 --count 3

Usage

datoteca <command> [options]

Common options (every command)

Flag	Description	Default
-s, --seed <seed>	Seed (integer or text)	1
-c, --count <count>	Number of records to generate	1
-f, --format <format>	Output format: json, csv, ndjson	json

Output always goes to stdout, so it composes with shell redirection:

npx @datoteca/cli person --seed 42 --count 100 --format csv > fixtures.csv
npx @datoteca/cli money --seed 42 --format ndjson | jq '.amount'

Commands

rut — Chilean RUT (same algorithm for people and companies)

datoteca rut --seed 42 --count 5
datoteca rut --rut-format dots --no-dv

Flag	Description	Default
--rut-format <format>	raw, dash, dots	dash
--no-dv	Omit the check digit	(included)

Output row: { rut }.

person — natural persons. Output row: { firstName, lastName, fullName }. No generator-specific flags; each field is drawn independently from the shared RNG stream, mirroring how @datoteca/cl itself works.

datoteca person --seed 42 --count 10 --format ndjson

address — Chilean addresses (real comunas). Output row: { commune, street, fullAddress }.

datoteca address --seed 42 --count 10 --format csv

phone — Chilean phone numbers. Output row: { mobile, landline }.

datoteca phone --seed 42 --count 10

money — CLP or UF amounts.

datoteca money --seed 42 --currency UF --min 10 --max 500 --count 20

Flag	Description	Default
--currency <currency>	CLP, UF	CLP
--min <min>	Minimum amount	generator default
--max <max>	Maximum amount	generator default

Output row: { currency, amount, formatted } — amount is the raw number, formatted is the es-CL formatted string (e.g. $45.000 or UF 1.234,56).

company — Chilean companies. Output row: { businessName, industry }.

datoteca company --seed 42 --count 10

Errors

Invalid arguments (negative --count, unknown --format, --min greater than --max, etc.) print a clear message to stderr and exit with a non-zero code — safe to use in scripts with set -e.

Determinism

datoteca person --seed 42 --count 5   # run twice, byte-for-byte identical output

Same as the core library: the guarantee is seed and call order together. See docs/determinism.md in the main repo for details.

License

MIT — see LICENSE.