Como pesquisar na base de código

<ph-0-0>

Visão geral do produto

A interface de pesquisa de código e navegação de origem (link em inglês) do Bazel é uma ferramenta baseada na Web para procurar repositórios de código-fonte do Bazel. Você pode usar esses recursos para navegar entre diferentes repositórios, ramificações e arquivos. Você também pode visualizar o histórico, as diferenças e as informações sobre culpados.

Como começar

Para acessar a interface de pesquisa de código e navegação de origem, abra https://source.bazel.build no navegador da Web.

A tela principal é exibida. Essa tela contém os seguintes componentes:

  1. A barra de ferramentas de navegação estrutural. Essa barra de ferramentas exibe seu local atual no repositório e permite mover rapidamente para outro repositório ou local dentro de um repositório, como um arquivo, branch ou commit, por exemplo.

  2. Uma lista de repositórios para navegação.

Há uma caixa de pesquisa na parte de cima da tela. Você pode usar essa caixa para pesquisar arquivos e códigos específicos.

Como trabalhar com repositórios

Como abrir um repositório

Para abrir um repositório, clique no nome dele na tela principal.

Como alternativa, você pode usar a barra de ferramentas “Localização atual” para procurar um repositório específico. Essa barra de ferramentas exibe seu local atual no repositório e permite mover rapidamente para outro repositório ou local dentro de um repositório, como um arquivo, branch ou commit, por exemplo.

Alternar repositórios

Para alternar para um repositório diferente, selecione o repositório na barra de ferramentas de navegação estrutural.

Visualizar um repositório em um commit específico

Para ver um repositório em um commit específico:

  1. Na visualização do repositório, selecione o arquivo.
  2. Na barra de ferramentas “Localização atual”, abra o menu Ramificação.
  3. No submenu exibido, clique em Fazer commit.
  4. Selecione o commit que você quer visualizar.

A interface agora mostra o repositório como ele existia no commit.

Abrir uma ramificação, confirmação ou tag

Por padrão, a interface de pesquisa de código e navegação de origem abre um repositório para a ramificação padrão. Para abrir uma ramificação diferente, na barra de ferramentas de navegação estrutural, clique no menu Branch/Commit/Tag. Um submenu é aberto, permitindo que você selecione uma ramificação usando um nome de ramificação, um nome de tag ou uma caixa de pesquisa.

  • Para selecionar um branch usando o nome dele, selecione Branch e clique no nome.
  • Para selecionar uma ramificação usando um nome de tag, selecione Tag e clique no nome.
  • Para selecionar um branch usando um código de commit, selecione Commit e clique no código.
  • Para pesquisar uma ramificação, confirmação ou tag, selecione o item correspondente e digite um termo na caixa de pesquisa.

Como trabalhar com arquivos

Quando você seleciona um repositório na tela principal, a tela muda para mostrar uma visualização dele. Se houver um arquivo README, o conteúdo dele vai aparecer no painel de arquivos, localizado no lado direito da tela. Caso contrário, será exibida uma lista de arquivos e pastas do repositório. No lado esquerdo da tela, há uma visualização em árvore dos arquivos e pastas do repositório. Use essa árvore para procurar e abrir arquivos específicos.

Observe que, ao visualizar um repositório, a barra de ferramentas de navegação estrutural agora tem três componentes:

  • Um menu Repositório, em que é possível selecionar repositórios diferentes
  • Um menu Branch/Commit/Tag, em que é possível selecionar ramificações, tags ou commits específicos.
  • Uma caixa Caminho do arquivo, que mostra o nome do arquivo ou da pasta atual e o caminho correspondente

Abrir um arquivo

Você pode abrir um arquivo navegando até seu diretório e selecionando-o. A visualização do repositório é atualizada para mostrar o conteúdo do arquivo no painel de arquivos e a localização dele no repositório no painel da árvore.

Conferir mudanças no arquivo

Para ver as alterações no arquivo:

  1. Na visualização do repositório, selecione o arquivo.
  2. Clique em ÚLTIMA MODIFICAÇÃO DE, localizado no canto superior direito.

O painel é atualizado para mostrar quem fez alterações no arquivo e quando.

Conferir o histórico de alterações

Para ver o histórico de alterações de um arquivo:

  1. Na visualização do repositório, selecione o arquivo.
  2. Clique em HISTÓRICO, localizado no canto superior direito. O painel Histórico de alterações é exibido, mostrando as confirmações do arquivo.

Ver revisões de código

Para revisões de código Gerrit, você pode abrir a ferramenta diretamente no painel "Histórico de alterações".

Para ver a revisão de código de um arquivo:

  1. Na visualização do repositório, selecione o arquivo.
  2. Clique em HISTÓRICO, localizado no canto superior direito. O painel “Histórico de alterações” será exibido, mostrando as confirmações do arquivo.
  3. Passe o cursor sobre um commit. Um botão Mais (três pontos verticais) será exibido.
  4. Clique no botão Mais.
  5. Selecione Ver revisão de código.

A ferramenta Gerrit Code Review será aberta em uma nova janela do navegador.

Abrir um arquivo em um commit específico

Para abrir um arquivo em um commit específico:

  1. Na visualização do repositório, selecione o arquivo.
  2. Clique em HISTÓRICO, localizado no canto superior direito. O painel “Histórico de alterações” será exibido, mostrando as confirmações do arquivo.
  3. Passe o cursor sobre um commit. O botão VISUALIZAR será exibido.
  4. Clique no botão VER.

Comparar um arquivo com uma confirmação diferente

Para comparar um arquivo em uma confirmação diferente:

  1. Na visualização do repositório, selecione o arquivo. Para comparar de duas confirmações diferentes, primeiro abra o arquivo nessa confirmação.
  2. Passe o cursor sobre um commit. Um botão DIFF é exibido.
  3. Clique no botão DIFF.

O painel de arquivos é atualizado para exibir uma comparação lado a lado entre os dois arquivos. A mais antiga das duas confirmações fica sempre à esquerda.

No painel "Histórico de alterações", as duas confirmações são destacadas e um rótulo indica se elas estão sendo exibidas à esquerda ou à direita.

Para alterar qualquer um dos arquivos, passe o cursor sobre o commit no painel “Histórico de alterações”. Em seguida, clique no botão Left ou Right para abrir a commit no lado esquerdo ou direito do diff.

Como navegar por referências cruzadas

Outra maneira de procurar repositórios de origem é usando referências cruzadas. Elas aparecem automaticamente como hiperlinks em um determinado arquivo de origem.

Para facilitar a identificação de referências cruzadas, clique em Referências cruzadas, localizado no canto superior direito. Essa opção mostra um sublinhado abaixo de todas as referências cruzadas em um arquivo.

Observação: se as referências cruzadas estiverem esmaecidas, isso indica que as referências cruzadas não estão disponíveis para esse arquivo.

Clique em uma referência para abrir o painel "Referência cruzada". Esse painel contém duas seções:

  • Uma seção Definição, que lista os arquivos que definem a referência
  • Uma seção References, que lista os arquivos em que a referência também aparece.

As duas seções mostram o nome do arquivo, bem como as linhas que contêm a referência. Para abrir um arquivo no painel "Referência cruzada", clique na entrada do número da linha. O arquivo aparece em uma nova seção do painel, permitindo que você continue a navegar pelo arquivo, mantendo o arquivo original em visualização.

Você pode continuar navegando por referências cruzadas usando o painel "Referência cruzada", assim como faz no painel "Arquivo". Ao fazer isso, o painel exibe uma trilha de navegação estrutural que pode ser usada para navegar entre diferentes referências cruzadas.

Pesquise arquivos ou snippets de código específicos usando a caixa de pesquisa na parte de cima da tela. As pesquisas sempre se baseiam na ramificação padrão.

Todas as pesquisas usam expressões regulares RE2 por padrão. Se você não quiser usar expressões regulares, coloque sua pesquisa entre aspas duplas (").

Observação:para pesquisar rapidamente um arquivo específico, adicione uma barra invertida na frente do ponto ou coloque o nome inteiro do arquivo entre aspas.

foo\.java
"foo.java"

Você pode refinar sua pesquisa usando os filtros a seguir.

Filtrar Outras opções Descrição Exemplo
lang: idioma: Faça uma correspondência exata por idioma do arquivo. Teste lang:java
file: filepath:
path:
f:
case:yes Pesquise com diferenciação de maiúsculas e minúsculas. Por padrão, as pesquisas não diferenciam maiúsculas de minúsculas. case:yes Hello World
class: Pesquise por um nome de classe. class:MainClass
function: func: Pesquise por um nome de função. função:imprimir
- Nega o termo da pesquisa. olá -mundo
\ Caracteres especiais de escape, como ., \ ou (. run\(\)
"[termo]" Realize uma pesquisa literal. "class:main"

Suporte adicional

Para informar um problema, clique no botão Feedback exibido no canto superior direito da tela e insira seu feedback no formulário fornecido.