volta completions

La commande volta completions génère des informations de complétion de commande pour votre shell. Elle a la syntaxe suivante :

Générer les complétions Volta

Par défaut, les complétions seront générées pour la valeur de votre shell actuel,
soit la valeur de `SHELL`. Si vous définissez l'option `<shell>`, les complétions
seront générées pour ce shell.

Si vous spécifiez un répertoire, les complétions seront écrites dans un fichier là ;
sinon, elles seront écrites sur `stdout`.

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

Drapeaux :
    -f, --force      Écraser les fichiers existants (s'il y en a).
        --verbose    Activer les diagnostics détaillés
        --quiet      Empêcher les sorties inutiles
    -h, --help       Imprimer les informations d'aide

Options :
    -o, --output <out_file>    Le fichier où écrire les complétions générées

Arguments :
    <shell>    Le Shell pour lequel générer les complétions [valeurs possibles : zsh, bash, fish, powershell, elvish]

Exemples

Générer des complétions pour votre shell actuel

# Générer des complétions et les imprimer sur stdout
volta completions

Générer des complétions pour un shell spécifique

# Générer des complétions Bash
volta completions bash

# Générer des complétions Zsh
volta completions zsh

# Générer des complétions Fish
volta completions fish

# Générer des complétions PowerShell
volta completions powershell

# Générer des complétions Elvish
volta completions elvish

Sortir les complétions vers un fichier

# Sauvegarder les complétions bash dans un fichier
volta completions bash -o volta.bash

# Sauvegarder les complétions zsh dans un fichier et forcer l'écrasement
volta completions zsh -o _volta -f

Installation des complétions

Après avoir généré les complétions, vous devez les installer pour votre shell. Voici les méthodes d'installation courantes pour différents shells :

Bash

# Générer et sauvegarder les complétions bash
volta completions bash > ~/.volta-completions.bash

# Ajouter à votre ~/.bashrc
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Appliquer les changements à la session actuelle
source ~/.bashrc

Zsh

# Créer le répertoire de complétions s'il n'existe pas
mkdir -p ~/.zsh/completions

# Générer et sauvegarder les complétions zsh
volta completions zsh > ~/.zsh/completions/_volta

# Ajouter à votre ~/.zshrc (si pas déjà inclus)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Appliquer les changements à la session actuelle
source ~/.zshrc

Fish

# Générer et sauvegarder les complétions fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish chargera automatiquement les complétions depuis ce répertoire

PowerShell

# Générer les complétions PowerShell
volta completions powershell > volta-completions.ps1

# Ajouter à votre profil PowerShell
echo '. /chemin/vers/volta-completions.ps1' >> $PROFILE

# Appliquer les changements à la session actuelle
. $PROFILE

Cas d'utilisation

Les complétions shell rendent l'utilisation de Volta plus efficace en :

1. Suggérant les sous-commandes disponibles quand vous tapez volta
2. Fournissant des noms d'outils pour des commandes comme volta install ou volta uninstall
3. Complétant les drapeaux et options
4. Améliorant la productivité en réduisant la frappe et les erreurs