Skip to content

docs: a runnable example for named merge slots and graph inputs - #17

Merged
psyinf merged 1 commit into
mainfrom
docs/named-pipeline
Sep 19, 2026
Merged

psyinf merged 1 commit into
mainfrom
docs/named-pipeline

Conversation

@psyinf

@psyinf psyinf commented Sep 19, 2026

Copy link
Copy Markdown
Owner

Adds apps/namedPipeline, one example app for the features of #15 and #16. Following the one-app-per-theme convention, the named-slot and named-input examples move there from apps/textPipeline.

The app shows

  • named slots: (after: reversed, before: upper) -> Compare, matched by name
  • slot checks: a misspelled slot name ("did you mean") and the slot it leaves unfed
  • several named inputs: push() for one, filter(GraphInputs{}.set(…).set(…)) for both, and the errors thrown for an unknown key or a mistyped value
  • input checks: a misspelled in.<key> against GraphInputs::of, reported at build time
  • both together: two named inputs meeting in a lambda merge with named slots (registerTypedMergeFilter with names), holes filled with defaults
  • toMermaid, labelling the merge's edges with the slot names

Docs

  • EXAMPLE.md: new section 10; the Named slots and Several named inputs subsections move there from sections 4 and 5, which keep a one-line pointer; sample table, run commands and full outputs updated
  • README: sample list and run commands
  • CHANGELOG: entry under Unreleased

Not included: the "done" paragraph in TODO.md still lists only the stateful and composite apps; it will be updated with the pending TODO.md edits.

Built with the windows-msvc-debug-developer-mode preset, no warnings; namedPipeline and textPipeline output matches EXAMPLE.md.

apps/namedPipeline covers names in a graph's wiring: a merge whose
same-typed slots are matched by name, a lambda merge with named slots,
a graph with several named inputs fed by push() and filter(), the
build-time and feed-time checks the names enable, and toMermaid
labelling a merge's edges with its slot names. EXAMPLE.md section 10
walks through it.

The named-slot and named-input blocks (3c and 4b) move there from
apps/textPipeline, which keeps to the core building blocks.
@psyinf
psyinf merged commit 2123524 into main Sep 19, 2026
3 checks passed
@psyinf
psyinf deleted the docs/named-pipeline branch September 19, 2026 20:52
@psyinf
psyinf restored the docs/named-pipeline branch September 19, 2026 20:53
@psyinf
psyinf deleted the docs/named-pipeline branch September 19, 2026 20:53
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.

1 participant