Repository navigation
Add rfl::cli::usage to generate usage and help text - #23
Open
clockblocker wants to merge 1 commit into
Open
clockblocker wants to merge 1 commit into
clockblocker wants to merge 1 commit into
Conversation
clockblocker
force-pushed
the
cli-usage-help-text
branch
from
November 14, 2026 13:01
d0ce41c to
95184e5
Compare
clockblocker
force-pushed
the
wave-base-4
branch
from
November 14, 2026 13:01
5f5bda8 to
55507ad
Compare
clockblocker
force-pushed
the
cli-usage-help-text
branch
from
November 15, 2026 08:21
95184e5 to
ea81d4e
Compare
clockblocker
force-pushed
the
wave-base-5
branch
from
November 16, 2026 05:18
ebe522c to
c171f71
Compare
clockblocker
force-pushed
the
cli-usage-help-text
branch
from
November 16, 2026 05:18
ea81d4e to
7452227
Compare
clockblocker
force-pushed
the
wave-base-5
branch
from
November 17, 2026 04:18
c171f71 to
576b6a2
Compare
clockblocker
force-pushed
the
cli-usage-help-text
branch
2 times, most recently
from
November 17, 2026 05:11
0d52e67 to
953f9db
Compare
clockblocker
force-pushed
the
wave-base-5
branch
2 times, most recently
from
November 17, 2026 07:15
64bb06b to
ca12ff5
Compare
clockblocker
force-pushed
the
cli-usage-help-text
branch
from
November 17, 2026 07:15
953f9db to
3d1b55f
Compare
rfl::cli::usage<T, Ps...>(program_name, detailed = false) returns the one-line usage form for the struct that rfl::cli::read<T, Ps...> parses into, and with detailed = true one row per argument: description, enum choices of positional arguments, and "Required.". It returns an rfl::Result<std::string>, with an error where no read of T can succeed. It walks the format-agnostic schema (rfl::parsing::schema::make) and takes positionals, short aliases and flags from the parser's option table, and requiredness from the same traits as the parser, so the help matches what read accepts. Implements munich-data-engineering#692. Co-Authored-By: Claude Opus 5.5 <[email protected]>
clockblocker
force-pushed
the
wave-base-5
branch
from
November 17, 2026 09:25
ca12ff5 to
c286ad9
Compare
clockblocker
force-pushed
the
cli-usage-help-text
branch
from
November 17, 2026 09:25
3d1b55f to
dcb5ff4
Compare
This was referenced Nov 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Implements munich-data-engineering/reflect-cpp#692: adds
rfl::cli::usage<T, Ps...>(program_name, detailed)to generate usage lines and aligned help text directly from a struct definition.Example
Key details
rfl::parsing::schema::make+ the CLI option table (no JSON backend dependency), so wrapper order, processors, nested structs, and enums stay in sync withrfl::cli::read.rfl::Result<std::string>(never throws); errors on invalid struct definitions such as duplicaterfl::Shortnames. Both forms end with\n.readdoes not handle--helpyet andusagedoes not emit-h, --help(added viarfl::cli::Appin Add--helpand--versionto rfl::cli through rfl::cli::App #28).cli.mdandREADME.md.AI-authored. Depends on: #21, #33, #34.