volta completions

Команда volta completions генерирует информацию об автодополнении команд для вашего shell. Имеет следующий синтаксис:

Генерирует автодополнения Volta

По умолчанию автодополнения будут сгенерированы для значения вашего текущего shell,
то есть значения `SHELL`. Если вы установите опцию `<shell>`, автодополнения будут сгенерированы для этого shell.

Если вы укажете директорию, автодополнения будут записаны в файл там;
иначе они будут записаны в `stdout`.

Использование:
    volta completions [FLAGS] [OPTIONS] <shell>

ФЛАГИ:
    -f, --force      Перезаписать существующий файл (если есть).
        --verbose    Включить подробную диагностику
        --quiet      Предотвратить ненужный вывод
    -h, --help       Напечатать справочную информацию

ОПЦИИ:
    -o, --output <out_file>    Файл для записи сгенерированных автодополнений

АРГУМЕНТЫ:
    <shell>    Shell для генерации автодополнений [возможные значения: zsh, bash, fish, powershell, elvish]

Примеры

Генерация автодополнений для вашего текущего Shell

# Генерировать автодополнения и вывести в stdout
volta completions

Генерация автодополнений для конкретного Shell

# Генерировать автодополнения для Bash
volta completions bash

# Генерировать автодополнения для Zsh
volta completions zsh

# Генерировать автодополнения для Fish
volta completions fish

# Генерировать автодополнения для PowerShell
volta completions powershell

# Генерировать автодополнения для Elvish
volta completions elvish

Вывод автодополнений в файл

# Сохранить автодополнения bash в файл
volta completions bash -o volta.bash

# Сохранить автодополнения zsh в файл с принудительной перезаписью
volta completions zsh -o _volta -f

Установка автодополнений

После генерации автодополнений вам нужно установить их для вашего shell. Вот общие методы установки для разных shell:

Bash

# Генерировать и сохранить автодополнения bash
volta completions bash > ~/.volta-completions.bash

# Добавить в ваш ~/.bashrc
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Применить изменения к текущей сессии
source ~/.bashrc

Zsh

# Создать директорию автодополнений, если не существует
mkdir -p ~/.zsh/completions

# Генерировать и сохранить автодополнения zsh
volta completions zsh > ~/.zsh/completions/_volta

# Добавить в ваш ~/.zshrc (если ещё не включено)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Применить изменения к текущей сессии
source ~/.zshrc

Fish

# Генерировать и сохранить автодополнения fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish автоматически загрузит автодополнения из этой директории

PowerShell

# Генерировать автодополнения PowerShell
volta completions powershell > volta-completions.ps1

# Добавить в ваш профиль PowerShell
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# Применить изменения к текущей сессии
. $PROFILE

Случаи использования

Автодополнения shell делают использование Volta более эффективным благодаря:

1. Предложению доступных подкоманд при вводе volta
2. Предоставлению имён инструментов для команд типа volta install или volta uninstall
3. Автодополнению флагов и опций
4. Повышению продуктивности за счёт уменьшения количества вводимого текста и ошибок