Skip to main content

Noções básicas de sintaxe de pesquisa

Durante a pesquisa no GitHub, é possível criar consultas que correspondam a palavras e números específicos.

Note

A sintaxe abaixo se aplica à pesquisa sem código. Para obter mais informações sobre a sintaxe de pesquisa de código, confira Entender a sintaxe de pesquisa de código do GitHub.

Consultar por valores maiores ou menores que outro valor

Use >, >=, < e <= para pesquisar valores maiores que, maiores ou iguais a, menores que e menores ou iguais a outro valor.

ConsultaExemplo
>ncats stars:>1000 corresponde aos repositórios com a palavra "cats" que têm mais de mil estrelas.
>=ncats topics:>=5 corresponde aos repositórios com a palavra "cats" que têm cinco tópicos ou mais.
<ncats size:<10000 corresponde ao código com a palavra "cats" em arquivos com menos de 10 KB.
<=ncats stars:<=50 corresponde aos repositórios com a palavra "cats" que têm 50 estrelas ou menos.

Use também consultas de intervalo para pesquisar valores maiores ou iguais a ou menores ou iguais a outro valor.

ConsultaExemplo
n..*cats stars:10..* é equivalente a stars:>=10 e corresponde aos repositórios com a palavra "cats" que têm dez estrelas ou mais.
*..ncats stars:*..10 é equivalente a stars:<=10 e corresponde aos repositórios com a palavra "cats" que têm dez estrelas ou menos.

Consultar por valores dentro de um intervalo

Use a sintaxe de intervalo n..n para pesquisar valores em um intervalo, em que o primeiro número N é o valor mais baixo e o segundo é o mais alto.

ConsultaExemplo
n..ncats stars:10..50 corresponde aos repositórios com a palavra "cats" que têm entre dez e 50 estrelas.

Consultar por datas

Pesquise datas anteriores ou posteriores a outra data ou que estejam em um intervalo de datas, usando >, >=, <, <= e consultas de intervalo. A formatação de data precisa seguir o padrão ISO8601, que é YYYY-MM-DD (ano-mês-dia).

ConsultaExemplo
>YYYY-MM-DDcats created:>2016-04-29 corresponde aos problemas com a palavra "cats" que foram criados após 29 de abril de 2016.
>=YYYY-MM-DDcats created:>=2017-04-01 corresponde aos problemas com a palavra "cats" que foram criados em 1º de abril de 2017 ou após essa data.
<YYYY-MM-DDcats pushed:<2012-07-05 corresponde a repositórios com a palavra "cats" que foram enviados por push antes de 5 de julho de 2012.
<=YYYY-MM-DDcats created:<=2012-07-04 corresponde aos problemas com a palavra "cats" que foram criados em 4 de julho de 2012 ou antes dessa data.
YYYY-MM-DD..YYYY-MM-DDcats pushed:2016-04-30..2016-07-04 corresponde aos repositórios com a palavra "cats" que foram enviados por push entre o final de abril e julho de 2016.
YYYY-MM-DD..*cats created:2012-04-30..* corresponde aos problemas criados em ou após 30 de abril de 2012 contendo a palavra "cats".
*..YYYY-MM-DDcats created:*..2012-07-04 corresponde aos problemas criados em ou antes de 4 de julho de 2012 contendo a palavra "cats".

Adicione também informações de hora THH:MM:SS+00:00 opcionais após a data, para fazer a pesquisa por hora, minuto e segundo. Isso é T, seguido de HH:MM:SS (hora-minutos-segundos) e uma diferença UTC (+00:00).

ConsultaExemplo
YYYY-MM-DDTHH:MM:SS+00:00cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 corresponde aos problemas criados entre 1º de janeiro de 2017 à 1h. com uma diferença UTC de 07:00 e 1º de março de 2017 às 15h. com uma diferença UTC de 07:00.
YYYY-MM-DDTHH:MM:SSZcats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z corresponde aos problemas criados entre 21 de março de 2016 às 14h11 e 7 de abril de 2016 às 20h45.

Excluir resultados que correspondam a um qualificador

Restrinja os resultados da pesquisa excluindo um ou mais subconjuntos. Para excluir todos os resultados correspondentes a um qualificador, adicione um hífen (-) como prefixo a qualquer qualificador de pesquisa.

ConsultaExemplo
-QUALIFIERcats stars:>10 -language:javascript corresponde aos repositórios com a palavra "cats" que têm mais de dez estrelas, mas que não foram escritos em JavaScript.
-QUALIFIERmentions:defunkt -org:github corresponde aos problemas que mencionam @defunkt e que não estão em repositórios na organização do GitHub.

Excluir resultados com palavras-chave específicas

É possível excluir os resultados que contêm determinada palavra usando a sintaxe NOT. O operador NOT só pode ser usado para palavras-chave de cadeia de caracteres. Ele não funciona com numerais ou datas.

ConsultaExemplo
NOThello NOT world corresponde aos repositórios que têm a palavra "hello", mas não a palavra "world".

Usar aspas para consultas com espaço em branco

Se a consulta de pesquisa contém espaço em branco, é preciso colocá-lo entre aspas. Por exemplo:

  • cats NOT "hello world" corresponde aos repositórios com a palavra "cats", mas não com as palavras "hello world".
  • build label:"bug fix" corresponde aos problemas com a palavra "build" que tem o rótulo "bug fix".

Consultas com nomes de usuário

Se a consulta de pesquisa contiver um qualificador que exija um nome de usuário, como user, actor ou assignee, você poderá usar qualquer nome de usuário do GitHub para especificar uma pessoa, @me para especificar o usuário atual ou @copilot para especificar o Copilot.

ConsultaExemplo
QUALIFIER:USERNAMEauthor:nat corresponde aos commits criados por @nat
QUALIFIER:@meis:issue assignee:@me corresponde aos problemas atribuídos à pessoa que está vendo os resultados
QUALIFIER:@copilotis:pr reviewed-by:@copilot corresponde às pull requests revisadas pelo Copilot. Para saber mais, confira Como usar a revisão de código do GitHub Copilot.

Só é possível usar @me ou @copilot com um qualificador, e não como um termo de pesquisa, como @me main.workflow.