completions #

Das completions-Kommando erzeugt Dateien, die Anweisungen enthalten, welche Argumente und Optionen des Toolkits für eine Shell zur Befehlszeilenergänzung verfügbar sind.

Beschreibung #

Hinweis

Mit jeder neuen pica-Version können sich die Argumente und Optionen des command-line interface (CLI) ändern. Daher ist ein regelmäßiges Updaten der Skripte zu empfehlen.

Nachfolgend werden exemplarisch die Befehle gezeigt, die für die Einbindung in die jeweilige Shell nötig sind. Die Schritte sind vom System sowie der Nutzereinstellung abhängig und müssen ggf. angepasst werden.

Es werden folgende Shells unterstützt:

• Bash,
• Elvish,
• Fish,
• Powershell
• und ZSH.

Bash #

$ mkdir -p ~/.local/share/bash-completion/completions
$ pica completions bash \
    -o  ~/.local/share/bash-completion/completions/pica

Bash (macOS/Homebrew) #

$ mkdir -p $(brew --prefix)/etc/bash_completion.d
$ pica completions bash \
    -o $(brew --prefix)/etc/bash_completion.d/pica.bash-completion

Elvish #

$ mkdir -p ~/.local/share/elvish/lib/completions
$ pica completions elvish -o ~/.local/share/elvish/lib/completions/pica.elv
$ echo "use completions/pica" >> ~/.elvish/rc.elv

Fish #

$ mkdir -p ~/.config/fish/completions
$ pica completions fish -o ~/.config/fish/completions/pica.fish

Powershell #

$ pica completions powershell \
     >> ${env:USERPROFILE}\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1

ZSH #

Der Pfad ~/.zfunc muss in der Variable $fpath gesetzt sein, bevor die Funktion compinit aufgerufen wird.

$ pica completions zsh -o ~/.zfunc/_pica