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.

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
• ZSH

Bash

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

Alternativ kann auch immer die aktuelle Version, passend zur installierten pica-Version, eingebunden werden. Dafür muss folgende Zeile in die .bashrc eingetragen werden:

$ source <(pica completions bash)

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