Skip to content

volta completions

Il comando volta completions genererà informazioni di completamento comandi per la tua shell. Ha la seguente sintassi:

bash
Genera completamenti Volta

Per impostazione predefinita, i completamenti saranno generati per il valore della tua shell corrente,
cioè il valore di `SHELL`. Se imposti l'opzione `<shell>`, i completamenti saranno generati per quella shell.

Se specifichi una directory, i completamenti saranno scritti in un file lì;
altrimenti, saranno scritti su `stdout`.

Uso:
    volta completions [FLAGS] [OPTIONS] <shell>

Flag:
    -f, --force      Sovrascrive file esistenti (se presenti).
        --verbose    Abilita diagnostiche dettagliate
        --quiet      Previene output non necessari
    -h, --help       Stampa informazioni di aiuto

Opzioni:
    -o, --output <out_file>    File in cui scrivere i completamenti generati

Argomenti:
    <shell>    Shell per cui generare completamenti [valori possibili: zsh, bash, fish, powershell, elvish]

Esempi

Generare completamenti per la tua shell corrente

bash
# Genera completamenti e stampa su stdout
volta completions

Generare completamenti per shell specifiche

bash
# Genera completamenti Bash
volta completions bash

# Genera completamenti Zsh
volta completions zsh

# Genera completamenti Fish
volta completions fish

# Genera completamenti PowerShell
volta completions powershell

# Genera completamenti Elvish
volta completions elvish

Output completamenti su file

bash
# Salva completamenti bash su file
volta completions bash -o volta.bash

# Salva completamenti zsh su file e forza sovrascrittura
volta completions zsh -o _volta -f

Installare completamenti

Dopo aver generato i completamenti, devi installarli per la tua shell. Ecco metodi comuni di installazione per diverse shell:

Bash

bash
# Genera e salva completamenti bash
volta completions bash > ~/.volta-completions.bash

# Aggiungi al tuo ~/.bashrc
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Applica cambiamenti alla sessione corrente
source ~/.bashrc

Zsh

bash
# Crea directory completamenti se non esiste
mkdir -p ~/.zsh/completions

# Genera e salva completamenti zsh
volta completions zsh > ~/.zsh/completions/_volta

# Aggiungi al tuo ~/.zshrc (se non già incluso)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Applica cambiamenti alla sessione corrente
source ~/.zshrc

Fish

bash
# Genera e salva completamenti fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish caricherà automaticamente i completamenti da questa directory

PowerShell

powershell
# Genera completamenti PowerShell
volta completions powershell > volta-completions.ps1

# Aggiungi al tuo profilo PowerShell
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# Applica cambiamenti alla sessione corrente
. $PROFILE

Casi d'uso

I completamenti shell rendono l'uso di Volta più efficiente nei seguenti modi:

  1. Suggeriscono sottocomandi disponibili quando digiti volta
  2. Forniscono nomi di strumenti per comandi come volta install o volta uninstall
  3. Completano flag e opzioni
  4. Migliorano la produttività riducendo input ed errori