Command-line completion generator for cobra with support for:
- Bash
- Elvish
- Fish
- Ion (experimental)
- Nushell (experimental)
- Oil
- Powershell
- Tcsh (experimental)
- Xonsh
- Zsh
WIP: works, but expect some api changes and small hiccups like a special character not yet escaped
Calling carapace.Gen on the root command is sufficient to enable completion script generation using the hidden command.
import (
"github.com/rsteube/carapace"
)
carapace.Gen(rootCmd)Carapace can also be used to provide completion for arbitrary commands as well (similar to aws_completer). See rsteube/carapace-bin for examples. There is also a binary to parse flags from gnu help pages at caraparse.
An example implementation can be found in the example folder.
cd example
go build .
# bash
PATH=$PATH:$(pwd)
source <(example _carapace bash)
# elvish
paths=[$@paths (pwd)]
eval (example _carapace elvish | slurp)
# fish
set PATH $PATH (pwd)
example _carapace fish | source
# oil
PATH=$PATH:$(pwd)
source <(example _carapace oil)
# powershell
Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete
$env:PATH += ":$pwd"
example _carapace powershell | out-string | Invoke-Expression
# tcsh
set autolist
eval `example _carapace tcsh`
# xonsh
$PATH.append($(pwd))
exec($(example _carapace xonsh))
# zsh
PATH=$PATH:$(pwd)
source <(example _carapace zsh)
example <TAB>or use docker-compose:
docker-compose pull
docker-compose run --rm build
docker-compose run --rm [bash|elvish|fish|ion|nushell|oil|powershell|tcsh|xonsh|zsh]
example <TAB>- carapace-bin multi-shell multi-command argument completer
- go-jira-cli simple jira command line client
- lab cli client for GitLab