Repository navigation
S10: bound query parameters with -a NAME=VALUE #14
Description
Part of #17. Design: docs/design.md §9 (R3).
Scope
-a/--arg NAME=VALUE (repeatable) binds query parameters ($name) safely, outside the script text:
relix -a id=42 order.relix
xargs -I{} relix -a id={} order.relix- An unbound parameter is an analysis error that names it.
fmt,bundleandoptimizeprint$name, never the value.
Dependencies
- Bound query parameters ($name) supplied outside the script text relix-core#82 (bound query parameters) has landed.
developpins the engine's1.0.0-SNAPSHOT, which tracks relix-core'sdevelop, so no pin bump is needed here. - Bind a parameter from text: convert a String to the parameter's analysed type relix-core#101 (bind a parameter from text). A
-avalue is always text, and the engine refuses a String for a parameter analysed as another type, so-a id=42against a NUMBER column fails until it lands. - S1 (S1: command skeleton — script sources, exit codes, diagnostics, profiles, engine options #4), merged.
Acceptance
- Binding through
Main. - A value holding a quote cannot change the query.
- The unbound-parameter error.
Activity
Add -a/--arg NAME=VALUE: bind query parameters outside the script text
david-Darkcollective commentedon Oct 9, 2026
Done in #39, merged to develop (88849b5).
-a/--arg NAME=VALUEbinds$NAMEoutside the script text. The value is text, which the engine reads as the parameter's analysed type (DarkCollective/relix-core#101), so-a id=42binds a number against a NUMBER column. A value holding a quote can't change the query. An unbound parameter is an analysis error (exit 3) that names it and says to use-a NAME=VALUE.fmt,bundleandoptimizeprint$name, never the value.QueryParametersTestcovers each of these throughMain.Add -a/--arg NAME=VALUE: bind query parameters outside the script text