dff-script

A Bun 1.4 CLI that generates files from sss-hbs templates. Mapping and Handlebars sources are read from that repository. CSV mapping uses CsvToJson from dff-util; rendering uses CallHbs.

bunx dff-script list
bunx dff-script hbs-cd-config '{"tenant":"dff","module":"astropeace"}'
bunx dff-script hbs-cd-ms '{"tenant":"dff","module":"astropeace","name":"auth","type":"ms"}'
bunx dff-script hbs-cd-ms dff:astropeace:auth:ms
bunx dff-script hbs-web-module user

list reads mapping.csv and prints every type with an hbs- prefix, for example hbs-cd-config, hbs-cd-ms, and hbs-gitignore.

Unquoted object keys are also accepted:

bunx dff-script hbs-cd-ms '{tenant:"dff", module:"astropeace", name:"auth", type:"ms"}'

For templates that only need a name, a plain string is accepted as shorthand for {"name":"..."}:

bunx dff-script hbs-web-module user

Colon-separated strings are also accepted as shorthand for common fields:

bunx dff-script hbs-cd-ms dff:astropeace:auth:ms
bunx dff-script hbs-cd-ms dff:astropeace:auth
bunx dff-script hbs-cd-config dff:astropeace

These map to tenant:module:name:type, with name and type optional. A single value like user or dff maps to {"name":"..."}.

These registry commands work after the package is published. To run from this repository now:

bun install
bun run build
cd /path/to/your/app
bun /Volumes/work/github/dff-script/dist/cli.js list
bun /Volumes/work/github/dff-script/dist/cli.js hbs-cd-config '{"tenant":"dff","module":"astropeace"}'
bun /Volumes/work/github/dff-script/dist/cli.js hbs-cd-ms '{"tenant":"dff","module":"astropeace","name":"auth","type":"ms"}'
bun /Volumes/work/github/dff-script/dist/cli.js hbs-cd-ms dff:astropeace:auth:ms
bun /Volumes/work/github/dff-script/dist/cli.js hbs-web-module user

list and each hbs-<type> command start from mapping.csv. The hbs- prefix is stripped to get the mapping type (hbs-cd-ms → cd-ms). Matching rows drive path, filename prefix, overwrite, and whether the file is rendered.

| Column | Role | | --- | --- | | type | Selected by the command after hbs- | | path | Directory under the current project (. is the project root) | | name | Output filename, after an optional rendered prefix | | prefix | Optional Handlebars prefix rendered with CallHbs | | overwrite | true replaces an existing file; false leaves it in place | | hbs | true renders the template with CallHbs; false copies it as-is |