명령줄 완성

문제 신고 소스 보기 Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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