GNU-style CLI flags, embedded data, and a literal format grammar #3

Merged

lilleman merged 38 commits from cli-and-syntax into main 2026-09-03 14:21:08 +02:00

Conversation 0 Commits 38 Files Changed 78

+4270 -2711

lilleman commented 2026-09-02 13:01:44 +02:00

Owner

Copy Link

Copy Source

Reworks the on-ramp and the format grammar around two goals: zero to a value in one command, and text that means what it says.

CLI — GNU-style flags (--seed 42, -n 3), any position, -- terminator; single-dash long forms rejected with the right spelling named. --data-path is now optional: data/ ships embedded, so go install then fejkdata sv_SE.person works with no checkout and no flags.

Grammar — format text is literal; class runs become {digits(n)}, {upper(n)}, {lower(n)} and # escaping is gone. Every string is a format. One spelling per shape: one-item choices, repeated items, inert objects, weight: 1 and repeat: 1 are load errors naming the right spelling. {..path} is now held like a sibling path, so cross-category correlation works; lowercase, uppercase and ascii transform a held draw.

Breaking. No tags exist yet, so there is no compatibility promise. Old class-char formats load and render literally rather than erroring — that is inherent to making text literal. New takes options instead of a slice. format-migration/ holds the one-shot conversion scripts; delete before the first tag.

README restructured around the grammar with the goal list and standing decisions; AGENTS.md added.

Reworks the on-ramp and the format grammar around two goals: zero to a value in one command, and text that means what it says. **CLI** — GNU-style flags (`--seed 42`, `-n 3`), any position, `--` terminator; single-dash long forms rejected with the right spelling named. `--data-path` is now optional: `data/` ships embedded, so `go install` then `fejkdata sv_SE.person` works with no checkout and no flags. **Grammar** — format text is literal; class runs become `{digits(n)}`, `{upper(n)}`, `{lower(n)}` and `#` escaping is gone. Every string is a format. One spelling per shape: one-item choices, repeated items, inert objects, `weight: 1` and `repeat: 1` are load errors naming the right spelling. `{..path}` is now held like a sibling path, so cross-category correlation works; `lowercase`, `uppercase` and `ascii` transform a held draw. **Breaking.** No tags exist yet, so there is no compatibility promise. Old class-char formats load and render literally rather than erroring — that is inherent to making text literal. `New` takes options instead of a slice. `format-migration/` holds the one-shot conversion scripts; delete before the first tag. README restructured around the grammar with the goal list and standing decisions; `AGENTS.md` added.

lilleman added 14 commits 2026-09-02 13:01:44 +02:00

Tests for GNU-style flags f773738243

GNU-style flags: --name, short aliases, any position, help on stdout cf9de21495

Tests for the shipped data layer, New options and concurrent Fake 91cbae2a44

Embed the shipped data, load any fs.FS, New takes options, Fake is safe for concurrent use f210c7a764

Tests for literal format text, brace escapes and the class builtins 99d8aa0fb7

Format text is literal; class runs are {digits(n)} {upper(n)} {lower(n)}; a string is a format ff4b243148

Tests for one spelling per shape: no one-item choice, repeated item or inert object de8c1d13e9

One spelling per shape: reject a one-item choice, a repeated item and an inert object; reshape the data 054f99c94f

Re-pin the seeded outputs now that a one-item choice draws nothing f0305f191f

Tests for references held like siblings and the lowercase, uppercase and ascii transforms 8fa33694b9

Hold a reference path like a sibling path; add the lowercase, uppercase and ascii transforms 31c2f12098

Tests that the README examples load, render and print what they claim 035e51d3e1

Restructure the README around the grammar, record the standing decisions, add the contributor rules 00a6160aa4

Key the repeated-item check on the string itself; marshal only objects 8cd603a2b1

lilleman added 2 commits 2026-09-02 14:09:50 +02:00

Tests for attached and bundled short flags, and = after a short flag f6782cf477

One path reads a flag's value: short flags attach and bundle, = after one is rejected naming the spelling 0ad88028c4

lilleman added 1 commit 2026-09-02 18:18:10 +02:00

Delete the grammar converters; their output is committed and re-running them corrupts it 88e71e666d

lilleman added 2 commits 2026-09-02 18:21:07 +02:00

Tests for a repeated bare token of a held name 5514b42b7b

Reject a repeated bare token of a held name, naming the single-token spelling c5c06375d8

lilleman force-pushed cli-and-syntax from 1e4921cdf3 to c5c06375d8 2026-09-02 18:21:07 +02:00 Compare

lilleman added 2 commits 2026-09-02 18:23:05 +02:00

Tests for weight 0, a never-numeric calc operand, the repeat product along a path, and ErrNoData 34c933b2b3

Reject weight 0, a never-numeric calc operand and a repeat product past the cap; the CLI classifies ErrNoData 1b1b93b35f

lilleman force-pushed cli-and-syntax from d72d326de5 to 1b1b93b35f 2026-09-02 18:23:05 +02:00 Compare

lilleman added 2 commits 2026-09-02 18:26:05 +02:00

Tests for reference sigils: / the root, . this folder, .. the folder above 5d1e567b8d

Reference sigils follow the filesystem: / the root, . this folder, .. the folder above 1bf5470c6f

lilleman force-pushed cli-and-syntax from fcc58a74ab to 1bf5470c6f 2026-09-02 18:26:05 +02:00 Compare

lilleman added 1 commit 2026-09-02 18:29:38 +02:00

Tests for the path walk; test files named for the modules they exercise 7581587a19

lilleman added 1 commit 2026-09-02 18:29:47 +02:00

One path walk under checkPath, descend, readField, pathLeaves and coverPath; split the hold and the render graph into their own files bcbf044290

lilleman added 1 commit 2026-09-02 18:31:40 +02:00

Decompose compileTemplate, checkBoundLevelsHeld and loadDir; gate cyclomatic complexity at 14 f9647ff6bb

lilleman added 1 commit 2026-09-02 18:32:13 +02:00

Record the compatibility policy, the override consequence and the deferred data de-duplication 1b8768e431

lilleman added 1 commit 2026-09-02 18:45:23 +02:00

Tests for two spellings of one reference being one level, and a slash after a sigil 512696722d

lilleman added 1 commit 2026-09-02 18:45:34 +02:00

Compare and cache a read by its one spelling, so two spellings of one reference are one level; reject a slash after a sigil naming the spelling fdbbf94d2c

lilleman added 2 commits 2026-09-02 19:06:23 +02:00

Tests for a bounded, streamed --repeat, rune-named flags, and --list with inert flags 5a75df8034

Bound --repeat at MaxRepeat and stream the renders; name an unknown flag by its rune; --list rejects an inert --repeat or --separator 3d3efbb642

lilleman force-pushed cli-and-syntax from 4c8f30406e to 3d3efbb642 2026-09-02 19:06:23 +02:00 Compare

lilleman added 1 commit 2026-09-02 19:08:27 +02:00

Tests for finite float bounds, plain integer args, constant samples and divisors, the default separator, binding keys in paths, DEL in ascii, and an unheld path 7b28dc36d9

lilleman force-pushed cli-and-syntax from 09e4e29125 to 7b28dc36d9 2026-09-02 19:08:27 +02:00 Compare

lilleman added 1 commit 2026-09-02 19:08:34 +02:00

Reject non-finite float bounds, unplain integer args, constant samples, a constant zero divisor and the default separator; a binding key is no path segment; ascii keeps DEL; an unheld path panics 4f9285ab5c

lilleman added 1 commit 2026-09-02 19:09:21 +02:00

Tests for the real data-path error, an empty data path, and a crypto/rand failure ae0527a26e

lilleman added 1 commit 2026-09-02 19:09:33 +02:00

Keep the real data-path error, reject an empty data path, and report a crypto/rand failure instead of seeding zero 08c7ef9b7f

lilleman added 1 commit 2026-09-02 19:09:52 +02:00

Record the repeat cap's reach, 64-bit only, the constant-divisor rule and the rejected default spellings; correct the repeat cap comment c5304bb6e7

lilleman added 1 commit 2026-09-02 19:24:49 +02:00

Tests for every branch of the constant-divisor fold, arg errors naming the spelling, and shell numbers at the CLI a9552ed966

lilleman added 1 commit 2026-09-02 19:25:22 +02:00

Give maxLen its own literal and repeats MaxRepeat; arg errors name the spelling and the range; write's comment says what Flush reports; assert 64-bit at compile time addba9abf7

lilleman changed title from Draft: GNU-style CLI flags, embedded data, and a literal format grammar to GNU-style CLI flags, embedded data, and a literal format grammar 2026-09-03 07:36:37 +02:00

lilleman merged commit addba9abf7 into main 2026-09-03 14:21:08 +02:00

lilleman deleted branch cli-and-syntax 2026-09-03 14:21:09 +02:00

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Assignees

Clear assignees

claes.eismar.se lilleman (Lilleman auf Larv) martin.siden

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: larvit/fejkdata#3