glenux-archive/spf13--cobra
1
0
Fork 0
mirror of https://github.com/spf13/cobra synced 2025-05-06 13:27:26 +00:00
Code Issues Projects Releases Packages Wiki Activity
spf13--cobra/zsh_completions.md
Chmouel Boudjnah 3fea27d230
Allow a default function to argument 
If user add an annotation with the
`cobra_annotations_zsh_completion_default_function` key and a value to a
function it will be used as a default completion for that command.

Signed-off-by: Chmouel Boudjnah <chmouel@chmouel.com>
2019-07-05 07:42:52 +02:00

2.1 KiB
Raw Blame History

Generating Zsh Completion for your cobra.Command

Cobra supports native Zsh completion generated from the root cobra.Command. The generated completion script should be put somewhere in your $fpath named _<YOUR COMMAND>.

What's Supported

  • Completion for all non-hidden subcommands using their .Short description.
  • Completion for all non-hidden flags using the following rules:
    • Filename completion works by marking the flag with cmd.MarkFlagFilename... family of commands.
    • The requirement for argument to the flag is decided by the .NoOptDefVal flag value - if it's empty then completion will expect an argument.
    • Flags of one of the various *Array and *Slice types supports multiple specifications (with or without argument depending on the specific type).
  • Completion of positional arguments using the following rules:
    • Argument position for all options below starts at 1. If argument position 0 is requested it will raise an error.
    • Use command.MarkZshCompPositionalArgumentFile to complete filenames. Glob patterns (e.g. "*.log") are optional - if not specified it will offer to complete all file types.
    • Use command.MarkZshCompPositionalArgumentWords to offer specific words for completion. At least one word is required.
    • It's possible to specify completion for some arguments and leave some unspecified (e.g. offer words for second argument but nothing for first argument). This will cause no completion for first argument but words completion for second argument.
    • If no argument completion was specified for 1st argument (but optionally was specified for 2nd) and the command has ValidArgs it will be used as completion options for 1st argument.
    • Argument completions only offered for commands with no subcommands.
    • Arbitary completion for a command. Using cobra_annotations_zsh_completion_default_function annotation you can specify a function for the first argument to a command to complete to.

What's not yet Supported

  • Whatever other feature you're looking for and doesn't exist :)