volta completions

O comando volta completions irá gerar informações de completação de comandos para seu shell. Ele tem a seguinte sintaxe:

Gerar completação do Volta

Por padrão, a completação será gerada para o valor do seu shell atual,
ou seja, o valor de `SHELL`. Se você definir a opção `<shell>`, a completação será gerada para esse shell.

Se você especificar um diretório, a completação será escrita em um arquivo lá;
caso contrário, será escrita em `stdout`.

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

Flags:
    -f, --force      Sobrescrever arquivo existente (se houver).
        --verbose    Habilitar diagnósticos detalhados
        --quiet      Prevenir saída desnecessária
    -h, --help       Imprimir informações de ajuda

Opções:
    -o, --output <out_file>    Arquivo para escrever a completação gerada

Argumentos:
    <shell>    Shell para o qual gerar completação [valores possíveis: zsh, bash, fish, powershell, elvish]

Exemplos

Gerar Completação para Seu Shell Atual

# Gerar completação e imprimir para stdout
volta completions

Gerar Completação para Shell Específico

# Gerar completação Bash
volta completions bash

# Gerar completação Zsh
volta completions zsh

# Gerar completação Fish
volta completions fish

# Gerar completação PowerShell
volta completions powershell

# Gerar completação Elvish
volta completions elvish

Enviar Completação para Arquivo

# Salvar completação bash em arquivo
volta completions bash -o volta.bash

# Salvar completação zsh em arquivo e forçar sobrescrita
volta completions zsh -o _volta -f

Instalando Completação

Após gerar a completação, você precisa instalá-la para seu shell. Aqui estão métodos comuns de instalação para diferentes shells:

Bash

# Gerar e salvar completação bash
volta completions bash > ~/.volta-completions.bash

# Adicionar ao seu ~/.bashrc
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Aplicar mudanças à sessão atual
source ~/.bashrc

Zsh

# Criar diretório de completação se não existir
mkdir -p ~/.zsh/completions

# Gerar e salvar completação zsh
volta completions zsh > ~/.zsh/completions/_volta

# Adicionar ao seu ~/.zshrc (se ainda não incluído)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Aplicar mudanças à sessão atual
source ~/.zshrc

Fish

# Gerar e salvar completação fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish carregará automaticamente a completação deste diretório

PowerShell

# Gerar completação PowerShell
volta completions powershell > volta-completions.ps1

# Adicionar ao seu arquivo de configuração PowerShell
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# Aplicar mudanças à sessão atual
. $PROFILE

Casos de Uso

A completação do shell torna o uso do Volta mais eficiente de várias formas:

1. Sugerir subcomandos disponíveis quando você digita volta
2. Fornecer nomes de ferramentas para comandos como volta install ou volta uninstall
3. Completar flags e opções
4. Melhorar produtividade reduzindo digitação e erros