mirror of
https://github.com/clap-rs/clap
synced 2024-12-15 15:22:30 +00:00
f70ebe89a7
Before we introduced actions, it required specific setups to engage with claps version and help printing. With actions making that more explicit, we don't get as much benefit from our multiple, obscure, ways of users customizing help Before - Modify existing help or version with `mut_arg` which would automatically be pushed down the command tree like `global(true)` - Create an new help or version and have it treated as if it was the built-in on (I think) - Use the same flags as built-in and have the built-in flags automatically disabled - Users could explicitly disable the built-in functionality and do what they want Now - `mut_arg` no longer works as we define help and version flags at the end - If someone defines a flag that overlaps with the built-ins by id, long, or short, a debug assert will tell them to explicitly disable the built-in - Any customization has to be done by a user providing their own. To propagate through the command tree, they need to set `global(true)`. Benefits - Hopefully, this makes it less confusing on how to override help behavior. Someone creates an arg and we then tell them how to disable the built-in - This greatly simplifies the arg handling by pushing more responsibility onto the developer in what are hopefully just corner cases - This removes about 1Kb from .text Fixes #3405 Fixes #4033
132 lines
3.9 KiB
Bash
132 lines
3.9 KiB
Bash
#compdef my-app
|
|
|
|
autoload -U is-at-least
|
|
|
|
_my-app() {
|
|
typeset -A opt_args
|
|
typeset -a _arguments_options
|
|
local ret=1
|
|
|
|
if is-at-least 5.2; then
|
|
_arguments_options=(-s -S -C)
|
|
else
|
|
_arguments_options=(-s -C)
|
|
fi
|
|
|
|
local context curcontext="$curcontext" state line
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*--single-quotes[Can be '/''always'/'', '/''auto'/'', or '/''never'/'']' /
|
|
'*--double-quotes[Can be "always", "auto", or "never"]' /
|
|
'*--backticks[For more information see `echo test`]' /
|
|
'*--backslash[Avoid '/''//n'/'']' /
|
|
'*--brackets[List packages /[filter/]]' /
|
|
'*--expansions[Execute the shell command with $SHELL]' /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
'*-V[Print version information]' /
|
|
'*--version[Print version information]' /
|
|
":: :_my-app_commands" /
|
|
"*::: :->my-app" /
|
|
&& ret=0
|
|
case $state in
|
|
(my-app)
|
|
words=($line[1] "${words[@]}")
|
|
(( CURRENT += 1 ))
|
|
curcontext="${curcontext%:*:*}:my-app-command-$line[1]:"
|
|
case $line[1] in
|
|
(cmd-single-quotes)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(cmd-double-quotes)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(cmd-backticks)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(cmd-backslash)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(cmd-brackets)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(cmd-expansions)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*-h[Print help information]' /
|
|
'*--help[Print help information]' /
|
|
&& ret=0
|
|
;;
|
|
(help)
|
|
_arguments "${_arguments_options[@]}" /
|
|
'*::subcommand -- The subcommand whose help message to display:' /
|
|
&& ret=0
|
|
;;
|
|
esac
|
|
;;
|
|
esac
|
|
}
|
|
|
|
(( $+functions[_my-app_commands] )) ||
|
|
_my-app_commands() {
|
|
local commands; commands=(
|
|
'cmd-single-quotes:Can be '/''always'/'', '/''auto'/'', or '/''never'/''' /
|
|
'cmd-double-quotes:Can be "always", "auto", or "never"' /
|
|
'cmd-backticks:For more information see `echo test`' /
|
|
'cmd-backslash:Avoid '/''//n'/''' /
|
|
'cmd-brackets:List packages /[filter/]' /
|
|
'cmd-expansions:Execute the shell command with $SHELL' /
|
|
'help:Print this message or the help of the given subcommand(s)' /
|
|
)
|
|
_describe -t commands 'my-app commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-backslash_commands] )) ||
|
|
_my-app__cmd-backslash_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-backslash commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-backticks_commands] )) ||
|
|
_my-app__cmd-backticks_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-backticks commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-brackets_commands] )) ||
|
|
_my-app__cmd-brackets_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-brackets commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-double-quotes_commands] )) ||
|
|
_my-app__cmd-double-quotes_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-double-quotes commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-expansions_commands] )) ||
|
|
_my-app__cmd-expansions_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-expansions commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__cmd-single-quotes_commands] )) ||
|
|
_my-app__cmd-single-quotes_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app cmd-single-quotes commands' commands "$@"
|
|
}
|
|
(( $+functions[_my-app__help_commands] )) ||
|
|
_my-app__help_commands() {
|
|
local commands; commands=()
|
|
_describe -t commands 'my-app help commands' commands "$@"
|
|
}
|
|
|
|
_my-app "$@"
|