Skip to content

docs: a glob page pinned by a conformance table - #1378

Merged
thekevinbot merged 4 commits into
mainfrom
claude/1259-glob-docs
Oct 7, 2026
Merged

thekevinbot merged 4 commits into
mainfrom
claude/1259-glob-docs

Conversation

@thekevinbot

@thekevinbot thekevinbot commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator

Fixes #1259

Retargeted to main after the #1258 stack merged.

What

  • New docs/reference/glob.md: why bash globstar, a fixture tree, a conformance table, the divergences with reasons, anchoring, edge cases. Linked from the sidebar, path-tables.md and config.md (whose glob-rule text now points at it).
  • packages/rust/tests/glob_conformance.rs parses the fixture and table out of glob.md and runs every row as a path-table (real dirsql binary, HOME set for ~/) and, minus the leading ./, as a config glob. The page is the data, so it cannot drift.
  • scripts/glob-conformance.sh check runs the same rows through bash -O globstar -O nullglob (dotglob off). Rows with no divergence tag must equal bash's output after three filters, one per divergence (files only, node_modules unless spelled, gitignored *.log). A tagged row must differ from raw bash, so a stale tag fails. CI never calls bash.
  • No existing test compared against bash; config_glob_parity.rs only compares the two dirsql surfaces, so this is a new file.

Red / green

Red run 37418784848: glob_conformance failed on ./[z.md and ./**/.*, behavior absent from the base then. Both are on main now; the test passes here.

E2E Verification

Docs and a test only; no packages/rust/src change, so no receipts. cargo test -p dirsql --features cli --test glob_conformance and scripts/glob-conformance.sh check were run. pnpm build in docs/ is clean.

Base automatically changed from claude/1258-config-links to main October 7, 2026 02:24
@thekevinbot
thekevinbot merged commit a47c602 into main Oct 7, 2026
83 checks passed
@thekevinbot
thekevinbot deleted the claude/1259-glob-docs branch October 7, 2026 02:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: a glob page (motivation, examples, divergences from bash), pinned by a conformance table

1 participant