Skip to content

volta setup

O comando volta setup irá habilitar o Volta modificando o PATH do usuário atual (de forma específica da plataforma) para incluir o diretório de shims do Volta. Ele tem a seguinte sintaxe:

bash
Habilitar Volta para o usuário atual

Uso:
    volta setup [FLAGS]

Flags:
        --verbose    Habilitar diagnósticos detalhados
        --quiet      Prevenir saída desnecessária
    -h, --help       Imprimir informações de ajuda

Configuração Unix

Em sistemas Unix (macOS e Linux), volta setup irá procurar por scripts de configuração usando a seguinte lista:

  • ~/.profile
  • ~/.bash_profile
  • ~/.bashrc
  • ~/.zshrc
  • ~/.config/fish/config.fish
  • Valor da variável de ambiente PROFILE

Para esses arquivos que existem, volta setup irá modificá-los para incluir as seguintes linhas:

  1. Definir a variável de ambiente VOLTA_HOME (geralmente definida como ~/.volta)
  2. Adicionar $VOLTA_HOME/bin à variável de ambiente PATH

Se o arquivo de configuração do seu shell atual (detectado usando a variável de ambiente $SHELL) não existir, ele será criado com conteúdo apropriado se possível.

Configuração Windows

No Windows, volta setup irá modificar a variável de ambiente Path do usuário para incluir o diretório de shims (%LOCALAPPDATA%\Volta\bin). Isso garante que comandos do Volta estejam disponíveis em todos os prompts de comando.

Exemplos

Configuração Básica

bash
# Executar processo de configuração
volta setup

Isso atualizará seus arquivos de configuração do shell e tornará o Volta disponível em seu shell.

Configuração Silenciosa

bash
# Executar configuração com saída mínima
volta setup --quiet

Quando Usar

O comando volta setup é útil em várias situações:

  1. Após instalação nova: Executar após instalar o Volta pela primeira vez
  2. Após remoção de configuração do shell: Se você editou manualmente arquivos de configuração do shell e removeu a configuração do Volta
  3. Novo usuário: Ao configurar o Volta para um novo usuário no sistema
  4. Após mudança de shell: Se você mudou para um shell diferente

Conteúdo Adicionado aos Seus Arquivos de Configuração

Para bash/zsh/sh, volta setup adiciona linhas similares a:

bash
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

Para o shell fish, ele adiciona:

fish
set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

Configuração Manual

Se você não quiser usar volta setup, pode adicionar o Volta ao seu PATH manualmente:

  1. Criar diretório principal do Volta (padrão ~/.volta no Unix, %LOCALAPPDATA%\Volta no Windows)
  2. Adicionar o diretório bin à sua variável de ambiente PATH
  3. Recarregar seu shell ou reiniciar seu terminal

Solução de Problemas

Se o Volta não estiver disponível após executar volta setup:

  1. Certifique-se de que você abriu uma nova janela de terminal
  2. Verifique se o diretório bin do Volta está em seu PATH (use echo $PATH no Unix, echo %PATH% no Windows)
  3. Verificar se o diretório principal do Volta existe
  4. Para sistemas Unix, verificar se seus arquivos de configuração do shell foram modificados corretamente