volta setup

Il comando volta setup abiliterà Volta modificando il PATH dell'utente corrente (in modo specifico per piattaforma) per includere la directory shim di Volta. Ha la seguente sintassi:

Abilita Volta per l'utente corrente

Uso:
    volta setup [FLAGS]

Flag:
        --verbose    Abilita diagnostiche dettagliate
        --quiet      Previene output non necessari
    -h, --help       Stampa informazioni di aiuto

Setup Unix

Su sistemi Unix (macOS e Linux), volta setup cercherà script di configurazione usando la seguente lista:

• ~/.profile
• ~/.bash_profile
• ~/.bashrc
• ~/.zshrc
• ~/.config/fish/config.fish
• Il valore della variabile d'ambiente PROFILE

Per questi file esistenti, volta setup li modificherà per includere le seguenti righe:

1. Definire la variabile d'ambiente VOLTA_HOME (solitamente impostata su ~/.volta)
2. Aggiungere $VOLTA_HOME/bin alla variabile d'ambiente PATH

Se il file di configurazione della tua shell corrente (rilevato usando la variabile d'ambiente $SHELL) non esiste, se possibile, lo creerà con contenuto appropriato.

Setup Windows

Su Windows, volta setup modificherà la variabile d'ambiente Path dell'utente per includere la directory shim (%LOCALAPPDATA%\Volta\bin). Questo assicura che i comandi Volta siano disponibili in tutti i prompt dei comandi.

Esempi

Setup base

# Esegui il processo di setup
volta setup

Questo aggiornerà i tuoi file di configurazione della shell e renderà Volta disponibile nella tua shell.

Setup silenzioso

# Esegui setup con output minimo
volta setup --quiet

Quando usare

Il comando volta setup è utile in diversi casi:

1. Dopo installazione pulita: Esegui dopo aver installato Volta per la prima volta
2. Dopo rimozione configurazione shell: Se hai modificato manualmente i file di configurazione della shell e rimosso la configurazione di Volta
3. Nuovo utente: Quando configuri Volta per un nuovo utente sul sistema
4. Dopo cambio shell: Se hai cambiato a una shell diversa

Contenuto aggiunto ai file di configurazione

Per bash/zsh/sh, volta setup aggiunge righe simili a:

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

Per fish shell, aggiunge:

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

Setup manuale

Se non vuoi usare volta setup, puoi aggiungere manualmente Volta al tuo PATH:

1. Crea la directory principale di Volta (predefinita ~/.volta su Unix, %LOCALAPPDATA%\Volta su Windows)
2. Aggiungi la directory bin alla tua variabile d'ambiente PATH
3. Ricarica la tua shell o riavvia il terminale

Risoluzione dei problemi

Se Volta non è disponibile dopo aver eseguito volta setup:

1. Assicurati di aver aperto una nuova finestra del terminale
2. Controlla se la directory bin di Volta è nel tuo PATH (usa echo $PATH su Unix, echo %PATH% su Windows)
3. Verifica che esista la directory principale di Volta
4. Per sistemi Unix, controlla se i tuoi file di configurazione della shell sono stati modificati correttamente