volta completions

El comando volta completions generará información de autocompletado de comandos para tu shell. Tiene la siguiente sintaxis:

Genera autocompletados de Volta

Por defecto, los autocompletados se generarán para el valor de tu shell actual,
es decir, el valor de `SHELL`. Si estableces la opción `<shell>`, los autocompletados
se generarán para ese shell en su lugar.

Si especificas un directorio, los autocompletados se escribirán a un archivo allí;
de lo contrario, se escribirán a `stdout`.

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

FLAGS:
    -f, --force      Sobrescribir un archivo existente, si lo hay.
        --verbose    Habilita diagnósticos verbosos
        --quiet      Previene salida innecesaria
    -h, --help       Imprime información de ayuda

OPTIONS:
    -o, --output <out_file>    Archivo donde escribir los autocompletados generados

ARGS:
    <shell>    Shell para generar autocompletados [valores posibles: zsh, bash, fish, powershell, elvish]

Ejemplos

Generar Autocompletados para Tu Shell Actual

# Generar autocompletados e imprimir a stdout
volta completions

Generar Autocompletados para un Shell Específico

# Generar autocompletados de Bash
volta completions bash

# Generar autocompletados de Zsh
volta completions zsh

# Generar autocompletados de Fish
volta completions fish

# Generar autocompletados de PowerShell
volta completions powershell

# Generar autocompletados de Elvish
volta completions elvish

Guardar Autocompletados en un Archivo

# Guardar autocompletados de bash en un archivo
volta completions bash -o volta.bash

# Guardar autocompletados de zsh en un archivo con sobrescritura forzada
volta completions zsh -o _volta -f

Instalando Autocompletados

Después de generar autocompletados, necesitarás instalarlos para tu shell. Aquí hay métodos de instalación comunes para diferentes shells:

Bash

# Generar y guardar autocompletados de bash
volta completions bash > ~/.volta-completions.bash

# Añadir a tu ~/.bashrc
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Aplicar cambios a la sesión actual
source ~/.bashrc

Zsh

# Crear un directorio para autocompletados si no existe
mkdir -p ~/.zsh/completions

# Generar y guardar autocompletados de zsh
volta completions zsh > ~/.zsh/completions/_volta

# Añadir a tu ~/.zshrc (si no está ya incluido)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Aplicar cambios a la sesión actual
source ~/.zshrc

Fish

# Generar y guardar autocompletados de fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish cargará automáticamente autocompletados desde este directorio

PowerShell

# Generar autocompletados de PowerShell
volta completions powershell > volta-completions.ps1

# Añadir a tu perfil de PowerShell
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# Aplicar cambios a la sesión actual
. $PROFILE

Casos de Uso

Los autocompletados de shell hacen usar Volta más eficiente al:

1. Sugerir subcomandos disponibles cuando escribes volta
2. Proporcionar nombres de herramientas para comandos como volta install o volta uninstall
3. Completar banderas y opciones
4. Mejorar la productividad reduciendo la escritura y errores