Como pesquisar na base de código

Visão geral do produto

A interface de pesquisa de código e de origem do Bazel é uma ferramenta baseada na Web para navegar pelos repositórios de código-fonte do Bazel. Você pode usar esses recursos para navegar entre diferentes repositórios, ramificações e arquivos. Também é possível conferir o histórico, as diferenças e as informações de atribuição.

Primeiros passos

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

A tela principal aparece. Ela contém os seguintes componentes:

1. A barra de ferramentas "Localização atual". 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 que você pode navegar.

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

Como trabalhar com repositórios

Abrir um repositório

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

Como alternativa, use a barra de ferramentas "Localização atual" para pesquisar 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 "Localização atual".

Conferir um repositório em um commit específico

Para conferir 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 Branch.
3. No submenu que aparece, clique em Commit.
4. Selecione o commit que você quer conferir.

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

Abrir um branch, commit ou tag

Por padrão, a interface de pesquisa de código e de origem abre um repositório para o branch padrão. Para abrir um branch diferente, na barra de ferramentas "Localização atual", clique no menu Branch/Commit/Tag. Um submenu é aberto, permitindo que você selecione um branch usando um nome de branch, 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 um branch 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 desse repositório. Se um arquivo README existir, o conteúdo dele vai aparecer no painel de arquivos, localizado no lado direito da tela. Caso contrário, uma lista de arquivos e pastas do repositório vai aparecer. No lado esquerdo da tela, há uma visualização em árvore dos arquivos e pastas do repositório. Você pode usar essa árvore para navegar e abrir arquivos específicos.

Quando você estiver visualizando um repositório, a barra de ferramentas "Localização atual" terá três componentes:

• Um menu Repository, em que você pode selecionar diferentes repositórios
• Um menu Branch/Commit/Tag , em que você pode selecionar branches, tags ou commits específicos
• Uma caixa File path, que mostra o nome do arquivo ou pasta atual e o caminho correspondente

Abrir um arquivo

Você pode abrir um arquivo navegando até o diretório dele 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 de árvore.

Conferir mudanças de arquivos

Para conferir mudanças de arquivos:

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

O painel de arquivos é atualizado para mostrar quem fez mudanças no arquivo e quando.

Conferir o histórico de alterações

Para conferir 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 aparece, mostrando os commits desse arquivo.

Conferir revisões de código

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

Para conferir 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" aparece, mostrando os commits desse arquivo.
3. Passe o cursor sobre um commit. Um botão Mais (três pontos verticais) aparece.
4. Clique no botão Mais.
5. Selecione Conferir revisão de código.

A ferramenta de revisão de código do Gerrit é 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" aparece, mostrando os commits desse arquivo.
3. Passe o cursor sobre um commit. Um botão CONFERIR aparece.
4. Clique no botão CONFERIR.

Comparar um arquivo com um commit diferente

Para comparar um arquivo em um commit diferente:

1. Na visualização do repositório, selecione o arquivo. Para comparar dois commits diferentes, primeiro abra o arquivo nesse commit.
2. Passe o cursor sobre um commit. Um botão DIFF aparece.
3. Clique no botão DIFF.

O painel de arquivos é atualizado para mostrar uma comparação lado a lado entre os dois arquivos. O mais antigo dos dois commits está sempre à esquerda.

No painel "Histórico de alterações", os dois commits são destacados, e um rótulo indica se o commit é mostrado à esquerda ou à direita.

Para mudar qualquer um dos arquivos, passe o cursor sobre o commit no painel "Histórico de alterações". Em seguida, clique no botão Esquerda ou Direita para abrir o commit no lado esquerdo ou direito da diferença.

Navegar por referências cruzadas

Outra maneira de navegar pelos repositórios de origem é usando referências cruzadas. Essas referências 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 Referências cruzadas estiver esmaecido, isso indica que as referências cruzadas não estão disponíveis para esse arquivo.

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

• Uma seção Definição, que lista o arquivo ou os arquivos que definem a referência
• Uma seção Referências, que lista os arquivos em que a referência também aparece

As duas seções mostram o nome do arquivo, bem como a linha ou 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 navegando pelo arquivo enquanto mantém o arquivo original em exibição.

Você pode continuar navegando pelas referências cruzadas usando o painel "Referência cruzada", assim como no painel "Arquivo". Quando você faz isso, o painel mostra um caminho de navegação, que pode ser usado para navegar entre diferentes referências cruzadas.

Pesquisar código

É possível pesquisar arquivos ou snippets de código específicos usando a caixa de pesquisa localizada na parte de cima da tela. As pesquisas são sempre feitas no branch 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 antes do ponto ou coloque o nome do arquivo inteiro entre aspas.

foo\.java
"foo.java"

Você pode refinar sua pesquisa usando os seguintes filtros.

Suporte adicional

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