@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.