コマンドラインの完了

問題を報告する ソースを表示

Bash と Zsh でコマンドライン補完（タブ補完とも呼ばれます）を有効にできます。これにより、コマンド名、フラグ名とフラグ値、ターゲット名をタブで補完できます。

Bash

Bazel には Bash 完了スクリプトが付属しています。

Bazel をインストールした場合:

  • APT リポジトリから作業が完了しました。Bash 完了スクリプトはすでに /etc/bash_completion.d にインストールされています。

  • Homebrew から完了です。Bash 完了スクリプトは、$(brew --prefix)/etc/bash_completion.d にすでにインストールされています。

  • GitHub からダウンロードしたインストーラから、次の操作を行います。

    1. 完了ファイルの絶対パスを探します。インストーラはそれを bin ディレクトリにコピーします。

      例: --user でインストーラを実行した場合、これは $HOME/.bazel/bin になります。インストーラを root として実行した場合、これは /usr/local/lib/bazel/bin になります。

    2. 次のいずれかを行います。

      • 完了ディレクトリにこのファイルをコピーします（存在する場合）。

        例: Ubuntu の場合は /etc/bash_completion.d ディレクトリです。

      • または、Bash の RC ファイルから完了ファイルを取得します。

        完了ファイルの絶対パスを使用して、~/.bashrc（Ubuntu の場合）または ~/.bash_profile（macOS の場合）に次のような行を追加します。

        source /path/to/bazel-complete.bash

  • ブートストラップ経由で:

    1. 完了スクリプトを作成します。

      bazel build //scripts:bazel-complete.bash

    2. 完了ファイルは bazel-bin/scripts/bazel-complete.bash に作成されます。

      次のいずれかを行います。

      • 完了ディレクトリにこのファイルがあればそれをコピーします。

        例: Ubuntu では、/etc/bash_completion.d ディレクトリです。

      • ローカル ディスク上の任意の場所（$HOME など）にコピーし、Bash の RC ファイルから完了ファイルをソースします。

        完了ファイルの絶対パスを使用して、~/.bashrc（Ubuntu の場合）または ~/.bash_profile（macOS の場合）に次のような行を追加します。

        source /path/to/bazel-complete.bash

Zsh

Bazel には Zsh の完了スクリプトがある。

Bazel をインストールした場合:

  • これで APT リポジトリから作業は完了です。Zsh 完了スクリプトはすでに /usr/share/zsh/vendor-completions にインストールされています。

    高度にカスタマイズされた .zshrc でオートコンプリートが機能しない場合は、次の解決策のいずれかをお試しください。

    .zshrc に次の行を追加します。

        zstyle :compinstall filename '/home/tradical/.zshrc'

    autoload -Uz compinit
    compinit

    または

    こちらの手順を行います。

    oh-my-zsh を使用している場合は、zsh-autocomplete プラグインをインストールして有効にすることをおすすめします。使用したくない場合は、上記のいずれかの解決策を使用します。

  • Homebrew から完了です。これで Zsh の完了スクリプトがすでに $(brew --prefix)/share/zsh/site-functions にインストールされています。

  • GitHub からダウンロードしたインストーラから、次の操作を行います。

    1. 完了ファイルの絶対パスを探します。インストーラはそれを bin ディレクトリにコピーします。

      例: --user でインストーラを実行した場合、これは $HOME/.bazel/bin になります。インストーラを root として実行した場合、これは /usr/local/lib/bazel/bin になります。

    2. このスクリプトを $fpath のディレクトリに追加します。

      fpath[1,0]=~/.zsh/completion/
mkdir -p ~/.zsh/completion/
cp /path/from/above/step/_bazel ~/.zsh/completion

      これを機能させるには、初めて rm -f ~/.zcompdump; compinit を呼び出す必要があります。

    3. 必要に応じて、.zshrc に以下を追加します。

      # This way the completion script does not have to parse Bazel's options
# repeatedly.  The directory in cache-path must be created manually.
zstyle ':completion:*' use-cache on
zstyle ':completion:*' cache-path ~/.zsh/cache