명령줄 완성

나이틀리 빌드 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7

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이 됩니다. 루트로 설치 프로그램을 실행한 경우 이 값은 /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이 됩니다. 루트로 설치 프로그램을 실행한 경우 이는 /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