Preenchimento de linha de comando

Informar um problema Ver código-fonte

É possível ativar o preenchimento da linha de comando, também conhecido como preenchimento automático de guias, no Bash e no Zsh. Isso permite preencher nomes de comandos, nomes de sinalizações, valores de sinalizações e nomes de destino dos arquivos.

Bash

O Bazel vem com um script de conclusão do Bash.

Se você instalou o Bazel:

  • No repositório APT, está pronto. O script de conclusão do Bash já está instalado no /etc/bash_completion.d.

  • Em seguida, está tudo pronto. O script de conclusão do Bash já está instalado em $(brew --prefix)/etc/bash_completion.d.

  • Em seguida, no instalador do download do GitHub:

    1. Localize o caminho absoluto do arquivo de conclusão. O instalador o copiou para o diretório bin.

      Exemplo: se você executou o instalador com --user, ele será $HOME/.bazel/bin. Se você executou o instalador como raiz, a mensagem será /usr/local/lib/bazel/bin.

    2. Escolha uma destas opções:

      • Copie esse arquivo para seu diretório de conclusão (se houver).

        Exemplo: no Ubuntu, é o diretório /etc/bash_completion.d.

      • Ou forneça o arquivo de conclusão do arquivo RC do Bash.

        Adicione uma linha semelhante à que aparece abaixo ao ~/.bashrc (no Ubuntu) ou ~/.bash_profile (no macOS) usando o caminho para o caminho absoluto do seu arquivo de conclusão:

        source /path/to/bazel-complete.bash
        
  • Por meio do bootstrap, faça o seguinte:

    1. Crie o script de conclusão:

      bazel build //scripts:bazel-complete.bash
      
    2. O arquivo de conclusão é criado em bazel-bin/scripts/bazel-complete.bash.

      Escolha uma destas opções:

      • Copie esse arquivo para seu diretório de conclusão, se você tiver um.

        Exemplo: no Ubuntu, é o diretório /etc/bash_completion.d

      • Copie-o em algum lugar no disco local, como para $HOME, e crie o arquivo de conclusão no arquivo RC do Bash.

        Adicione uma linha semelhante à que aparece abaixo ao ~/.bashrc (no Ubuntu) ou ~/.bash_profile (no macOS) usando o caminho para o caminho absoluto do seu arquivo de conclusão:

        source /path/to/bazel-complete.bash
        

Zsh

O Bazel vem com um script de conclusão Zsh.

Se você instalou o Bazel:

  • No repositório APT, está pronto. O script de conclusão do Zsh já está instalado no /usr/share/zsh/vendor-completions.

    Se você tem um .zshrc altamente personalizado e o preenchimento automático não funciona, tente uma destas soluções:

    Adicione o seguinte ao seu .zshrc:

        zstyle :compinstall filename '/home/tradical/.zshrc'
    
        autoload -Uz compinit
        compinit
    

    ou

    Siga as instruções aqui.

    Se você estiver usando o oh-my-zsh, recomendamos instalar e ativar o plug-in zsh-autocomplete. Se você não quiser fazer isso, use uma das soluções descritas acima.

  • Em seguida, está tudo pronto. O script de conclusão do Zsh já está instalado no $(brew --prefix)/share/zsh/site-functions.

  • Em seguida, no instalador do download do GitHub:

    1. Localize o caminho absoluto do arquivo de conclusão. O instalador o copiou para o diretório bin.

      Exemplo: se você executou o instalador com --user, ele será $HOME/.bazel/bin. Se você executou o instalador como raiz, a mensagem será /usr/local/lib/bazel/bin.

    2. Adicione este script a um diretório no $fpath:

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

      Talvez seja necessário chamar rm -f ~/.zcompdump; compinit na primeira vez para que ele funcione.

    3. Opcionalmente, adicione o seguinte ao seu arquivo .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