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.

Nota: 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 em particular ou @me para especificar o usuário atual.

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

Você só pode usar @me com um qualificador e não como termo de pesquisa, como @me main.workflow.