Skip to content

Add pipeline recipes: other programs' output, relix into relix, loops, CI - #53

Merged
david-Darkcollective merged 1 commit into
developfrom
docs/more-pipeline-recipes
Oct 13, 2026
Merged

david-Darkcollective merged 1 commit into
developfrom
docs/more-pipeline-recipes

Conversation

@david-Darkcollective

@david-Darkcollective david-Darkcollective commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

The Pipelines page of the command-line guide gains six recipes:

  • Another program's output, as a table: a web server log split by awk into TSV with a header, counted by relix.
  • One relix into another: the reports project's Orders piped into a run in the shop that joins it to Customers, which is how to join tables two projects declare.
  • Keep the rows, print a summary: tee keeps the detail in a file while a second relix summarises it.
  • One output file per value: a shell loop runs the parameterised by-city.relix once per city a first query lists.
  • Has anything changed since yesterday?: EXCEPT over two snapshots, with --fail-rows setting the exit status.
  • In a workflow: a GitHub Actions job that installs the latest release with gh release download, runs relix check and a --fail-rows assertion, and appends a -o markdown table to $GITHUB_STEP_SUMMARY. The Markdown it appends is shown by a run example.

The page's introduction, the section README's row and index.json's summary are updated to match.

Every new shell block runs in GuideExamplesTest against the fixture shop, like the rest of the page. The workflow is a yaml block and is not run. ./gradlew clean build passes.

…, CI

The Pipelines page covered jq, awk, find and xargs, and a one-line data
check. It now also shows turning another program's columns into a table
(a web log through awk), one relix into another to join tables two
projects declare, tee to keep the rows while a second relix summarises
them, a shell loop writing one file per value with a bound parameter,
comparing two snapshots with EXCEPT and --fail-rows, and a GitHub
Actions workflow that installs the latest release with gh and adds a
Markdown table to the run's summary. Every new shell example runs in
GuideExamplesTest, like the rest of the page.
@david-Darkcollective
david-Darkcollective merged commit 717ba22 into develop Oct 13, 2026
3 checks passed
@david-Darkcollective
david-Darkcollective deleted the docs/more-pipeline-recipes branch October 13, 2026 13:21
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