Skip to content

Print shell completions and man pages - #9

Merged
tauanbinato merged 3 commits into
mainfrom
completions-and-man
Sep 25, 2026
Merged

tauanbinato merged 3 commits into
mainfrom
completions-and-man

Conversation

@tauanbinato

Copy link
Copy Markdown
Contributor

What and why

Phase 3 of the roadmap.

  • jevgate completions bash|zsh|fish|elvish|powershell prints a completion script (clap_complete).
  • jevgate man [COMMAND] prints the page for jevgate or jevgate-COMMAND in roff (clap_mangen), with the long help, examples and the JSON report guide.
  • Both are generated from the clap definitions, so they can't drift from --help, and run offline before configuration is read.
  • The Homebrew formula (from the next release) installs completions for bash, zsh and fish and every man page.

How it was checked

  • CLI tests for every shell and for man page names and unknown commands.
  • The formula was installed from a local test tap built with this binary: completions landed in Homebrew's bash, zsh and fish directories, and man -w jevgate-check finds the page.
  • cargo +1.90.0 check --locked and cargo deny check pass with the two new dependencies.

jevgate completions SHELL and jevgate man [COMMAND] are generated from the command-line definition, so they match --help. The Homebrew formula installs both.
main.rs keeps the command-line definition and entry point; command.rs runs each command, as the self-review suggested.
run only routes each command; init and accepting the baseline are their own functions, and check runs from its own module, as the self-review suggested.
@tauanbinato
tauanbinato merged commit 811595e into main Sep 25, 2026
12 checks passed
@tauanbinato
tauanbinato deleted the completions-and-man branch September 25, 2026 21:38
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