Skip to content

volta completions

Lệnh volta completions sẽ tạo thông tin hoàn thành lệnh cho shell của bạn. Nó có cú pháp sau:

bash
Tạo completions cho Volta

Theo mặc định, completions sẽ được tạo cho giá trị shell hiện tại của bạn,
tức giá trị của `SHELL`. Nếu bạn đặt tùy chọn `<shell>`, completions
sẽ được tạo cho shell đó thay thế.

Nếu bạn chỉ định một thư mục, completions sẽ được ghi vào một file đó;
ngược lại, chúng sẽ được ghi vào `stdout`.

CÁCH SỬ DỤNG:
    volta completions [FLAGS] [OPTIONS] <shell>

FLAGS:
    -f, --force      Ghi đè lên file hiện có, nếu có.
        --verbose    Kích hoạt chẩn đoán chi tiết
        --quiet      Ngăn chặn đầu ra không cần thiết
    -h, --help       In thông tin trợ giúp

OPTIONS:
    -o, --output <out_file>    File để ghi completions đã tạo vào

ARGS:
    <shell>    Shell để tạo completions cho [giá trị khả dĩ: zsh, bash, fish, powershell, elvish]

Ví dụ

Tạo Completions cho Shell Hiện tại của bạn

bash
# Tạo completions và in ra stdout
volta completions

Tạo Completions cho một Shell Cụ thể

bash
# Tạo completions cho Bash
volta completions bash

# Tạo completions cho Zsh
volta completions zsh

# Tạo completions cho Fish
volta completions fish

# Tạo completions cho PowerShell
volta completions powershell

# Tạo completions cho Elvish
volta completions elvish

Xuất Completions ra một File

bash
# Lưu completions bash vào một file
volta completions bash -o volta.bash

# Lưu completions zsh vào một file với ghi đè bắt buộc
volta completions zsh -o _volta -f

Cài đặt Completions

Sau khi tạo completions, bạn sẽ cần cài đặt chúng cho shell của mình. Đây là các phương pháp cài đặt phổ biến cho các shell khác nhau:

Bash

bash
# Tạo và lưu completions bash
volta completions bash > ~/.volta-completions.bash

# Thêm vào ~/.bashrc của bạn
echo 'source ~/.volta-completions.bash' >> ~/.bashrc

# Áp dụng các thay đổi cho phiên hiện tại
source ~/.bashrc

Zsh

bash
# Tạo một thư mục cho completions nếu nó không tồn tại
mkdir -p ~/.zsh/completions

# Tạo và lưu completions zsh
volta completions zsh > ~/.zsh/completions/_volta

# Thêm vào ~/.zshrc của bạn (nếu chưa được bao gồm)
echo 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

# Áp dụng các thay đổi cho phiên hiện tại
source ~/.zshrc

Fish

bash
# Tạo và lưu completions fish
volta completions fish > ~/.config/fish/completions/volta.fish

# Fish sẽ tự động tải completions từ thư mục này

PowerShell

powershell
# Tạo completions PowerShell
volta completions powershell > volta-completions.ps1

# Thêm vào hồ sơ PowerShell của bạn
echo '. /path/to/volta-completions.ps1' >> $PROFILE

# Áp dụng các thay đổi cho phiên hiện tại
. $PROFILE

Trường hợp Sử dụng

Shell completions làm cho việc sử dụng Volta hiệu quả hơn bằng cách:

  1. Gợi ý các lệnh phụ khả dĩ khi bạn gõ volta
  2. Cung cấp tên công cụ cho các lệnh như volta install hoặc volta uninstall
  3. Hoàn thành các cờ và tùy chọn
  4. Cải thiện năng suất bằng cách giảm gõ và lỗi

Released under the BSD 2-Clause License.