Filtrando e pesquisando problemas e pull requests

Para encontrar informações detalhadas sobre um repositório em GitHub, você pode filtrar, ordenar e pesquisar problemas e pull requests que são relevantes para o repositório.

Tool navigation

Neste artigo

Tip

Você também pode filtrar problemas ou pull requests usando o GitHub CLI. Para obter mais informações, confira "gh issue list" ou "gh pr list" na documentação da GitHub CLI.

Filtrar problemas e pull requests

Problemas e pull requests possuem um conjunto de filtros padrão que podem ser aplicados para organizar suas listas.

É possível filtrar problemas e pull requests para encontrar:

  • Todos os problemas e pull requests abertos
  • Problemas e pull requests criados
  • Problemas e pull requests atribuídos a você
  • Problemas e solicitações de pull em que você é @mentioned

Tip

Você também pode filtrar problemas ou pull requests usando o GitHub CLI. Para obter mais informações, confira "gh issue list" ou "gh pr list" na documentação da GitHub CLI.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista, clique no menu suspenso Filtros e selecione o tipo de filtro desejado.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um menu suspenso "Filtros" com o contorno em laranja escuro.

Como criar filtros avançados para problemas

Note

Os tipos de problemas, subproblemas e a pesquisa avançada de problemas estão atualmente em uma aceitação versão prévia pública para organizações. Para saber mais e adicionar sua organização à lista de espera, consulte o "Blog do GitHub".

Você pode criar filtros avançados usando consultas boolianas e aninhadas na página de problemas do seu repositório. À medida que você digita seu filtro, GitHub mostrará os qualificadores disponíveis, sugerirá valores e avisará quando houver um problema com seu filtro.

Como utilizar operadores boolianos

Você pode usar operadores AND e OR para refinar seus filtros.

Use AND quando precisar de resultados em que ambas as instruções sejam verdadeiras. No filtro de exemplo abaixo, os resultados serão compostos por problemas com o rótulo "Correção de bug" atribuído ao usuário @octocat.

label:"Bug fix" AND assignee:octocat

Para retornar resultados em que qualquer uma das instruções é verdadeira, use OR. No exemplo abaixo, os resultados conterão problemas atribuídos a @octocat ou @hubot.

assignee:octocat OR assignee:hubot

Se você optar por não usar os operadores AND e OR, GitHub tratará um espaço entre as instruções como um operador AND, a menos que você esteja usando um campo org, repo ou user para filtrar por propriedade, onde todos os espaços serão tratados como um operador OR.

Como usar parênteses para filtros mais complicados

Você também pode usar parênteses para aninhar filtros e agrupar qualificadores. No exemplo abaixo, os resultados conterão problemas atribuídos a @octocat com o tipo de problema “Bug” ou atribuídos a @hubot com o tipo de problema “Aprimoramento”.

(type:"Bug" AND assignee:octocat) OR (type:"Enhancement" AND assignee:hubot)

Você pode aninhar filtros usando parênteses de até cinco níveis de profundidade. No momento, não é possível incluir os qualificadores repo, org, ou user entre parênteses.

Filtrar problemas e pull requests por responsáveis

Depois de atribuir um problema ou uma solicitação de pull a alguém, você pode encontrar itens com base na pessoa que está trabalhando neles.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique no menu suspenso Destinatário.

    Captura de tela de uma lista de problemas. No cabeçalho acima da lista, há um menu suspenso "Destinatários" com o contorno em laranja escuro.

  4. O menu suspenso Assignee (Responsável) lista todas as pessoas que têm acesso de gravação no repositório. Clique no nome da pessoa cujos itens atribuídos deseja ver ou clique em Atribuído a ninguém para ver os problemas que estão sem atribuição.

Tip

Para limpar a seleção de filtro, clique em Limpar a consulta de pesquisa atual, filtros e classificações.

Filtrar problemas e pull requests por etiquetas

Depois de aplicar rótulos a um problema ou uma solicitação de pull, você pode encontrar itens com base nos respectivos rótulos.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique em Rótulos.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um botão com um ícone de rótulo "Rótulos" e o contorno em laranja escuro.

  4. Na lista de rótulos, clique em um rótulo.

Tip

Para limpar a seleção de filtro, clique em Limpar a consulta de pesquisa atual, filtros e classificações.

Filtragem por tipo de problema

Note

Os tipos de problemas, subproblemas e a pesquisa avançada de problemas estão atualmente em uma aceitação versão prévia pública para organizações. Para saber mais e adicionar sua organização à lista de espera, consulte o "Blog do GitHub".

Se sua organização usa tipos de problema, você pode filtrar problemas para um tipo específico. Você também pode digitar o qualificador type: diretamente no filtro.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do seu repositório, clique em Problemas.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Problemas", é destacada em laranja escuro.

  3. Acima da lista de problemas, selecione o menu suspenso Tipos.

    Captura de tela de uma lista de problemas. No cabeçalho acima da lista, há um menu suspenso rotulado "Tipos" com o contorno em laranja escuro e onde o menu Tipos de problemas está aberto.

  4. Na lista de tipo, clique em um tipo de problema.

Filtrar pull requests por status de revisão

É possível usar filtros para listar pull requests por status de revisão e encontrar as que você revisou ou outras pessoas solicitaram que você revisasse.

Você pode filtrar uma lista de pull requests do repositório para encontrar:

  1. Em GitHub, acesse a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Solicitações de pull.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Solicitações de pull", é destacada em laranja escuro.

  3. No canto superior direito, selecione o menu suspenso Revisões.

    Captura de tela do menu de filtro acima da lista de solicitações de pull. O menu suspenso "Revisões" está contornado em laranja escuro.

  4. Escolha um filtro para encontrar todas as pull requests com o status do filtro.

Usar a pesquisa para filtrar problemas e pull requests

Você pode usar filtros para pesquisar problemas e pull requests que atendam a critérios específicos.

Pesquisando problemas e pull requests

A barra de pesquisa de problemas e pull requests permite que você defina seus próprios filtros personalizados e ordene por uma ampla variedade de critérios. Encontre a barra de pesquisa nas guias Problemas e Solicitações pull de cada repositório e nos painéis Problemas e Solicitações de pull.

Captura de tela da lista de problemas de um repositório. Acima da lista, há um campo de pesquisa com a consulta "is:issue is:open" que tem o contorno em laranja escuro.

Tip

Você pode focar o cursor na barra de pesquisa acima da lista de problemas ou pull request com um atalho de teclado. Para obter mais informações, confira "Atalhos do teclado".

Note

Para saber mais sobre GitHub CLI, confira "Sobre o a CLI do GitHub".

Você pode usar o GitHub CLI para pesquisar problemas ou pull requests. Use o subcomando gh issue list ou gh pr list subcomando com o argumento --search e uma consulta de pesquisa.

Por exemplo, você pode listar, por ordem de data criada, todos os problemas que não têm um destinatário e que têm o rótulo help wanted ou bug.

gh issue list --search 'no:assignee label:"help wanted",bug sort:created-asc'

Você também pode listar todas as solicitações de pull que mencionam a equipe octo-org/octo-team.

gh pr list --search "team:octo-org/octo-team"

Sobre termos de pesquisa

Com os termos da pesquisa de problemas e pull requests, é possível:

  • Filtrar problemas e solicitações de pull por autor: state:open type:issue author:octocat
  • Filtrar problemas e solicitações de pull que envolvem, mas não necessariamente @mention , determinadas pessoas: state:open type:issue involves:octocat
  • Filtrar problemas e solicitações de pull por destinatário: state:open type:issue assignee:octocat
  • Filtrar problemas e solicitações de pull por rótulo: state:open type:issue label:"bug"
  • Filtrar os termos de pesquisa usando - antes do termo: state:open type:issue -author:octocat

Tip

Você pode filtrar problemas e solicitações de pull por etiqueta usando OR lógico ou AND lógico.

  • Para filtrar problemas usando OR lógico, use a sintaxe de vírgula: label:"bug","wip".
  • Para filtrar problemas usando AND lógico, use filtros de rótulo separados: label:"bug" label:"wip".

Para problemas, você também pode usar a busca para:

  • Filtre por problemas vinculados a uma solicitação pull por uma referência de fechamento: linked:pr
  • Filtre os problemas pelo motivo pelo qual eles foram fechados: is:closed reason:completed ou is:closed reason:"not planned"
  • Filtre por problemas com um tipo específico: is:open type:"Bug"

Para pull requests, você também pode usar a pesquisa para:

  • Filtrar solicitações de pull de rascunho : is:draft
  • Filtrar solicitações de pull que ainda não foram revisadas: state:open type:pr review:none
  • Filtrar solicitações de pull que exigem uma revisão para serem mescladas: state:open type:pr review:required
  • Filtrar solicitações de pull aprovadas por um revisor: state:open type:pr review:approved
  • Filtrar solicitações de pull nas quais um revisor solicitou alterações: state:open type:pr review:changes_requested
  • Filtrar solicitações de pull por revisor: state:open type:pr reviewed-by:octocat
  • Filtrar as solicitações de pull pelo usuário específico solicitado para revisão: state:open type:pr review-requested:octocat
  • Filtrar as solicitações de pull cuja revisão alguém solicitou diretamente a você: state:open type:pr user-review-requested:@me
  • Filtrar solicitações de pull da equipe solicitadas para revisão: state:open type:pr team-review-requested:github/docs
  • Filtrar solicitações de pull que estão vinculadas a um problema que a solicitação de pull poderá fechar: linked:issue
  • Filtrar pull requests por estado de mesclagem: is:merged ou is:unmerged

Ordenar problemas e pull requests

Filtros podem ser ordenados para fornecer informações melhores durante um período específico.

Você pode ordenar qualquer exibição filtrada por:

  • Prolemas ou pull requests com data de criação mais recente
  • Prolemas ou pull requests com data de criação mais antiga
  • Problemas ou pull requests com mais comentários
  • Problemas ou pull requests com menos comentários
  • Prolemas ou pull requests com data de atualização mais recente
  • Prolemas ou pull requests com data de atualização mais antiga
  • A reação mais adicionada em problemas ou pull requests

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique no menu suspenso Classificar e selecione um método de classificação.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um menu suspenso "Classificação" com o contorno em laranja escuro.

Para limpar a seleção de classificação, clique em Classificar > Mais Recente.

Compartilhar filtros

Quando você filtra ou ordena problemas e pull requests, a URL do navegador é automaticamente atualizada para corresponder à nova exibição.

Você pode enviar a URL que geradas pelos problemas para qualquer usuário e ele verá a mesma exibição com filtro que você.

Por exemplo, se você filtrar por problemas atribuídos a Hubot e ordenar pelos problemas abertos mais antigos, a URL seria atualizada para algo como o seguinte:

/issues?q=state:open+type:issue+assignee:hubot+sort:created-asc

Leitura adicional