Entender a sintaxe de pesquisa
Durante a pesquisa no GitHub Enterprise, é possível criar consultas que correspondam a palavras e números específicos.
Consultar por valores maiores ou menores que outro valor
Você pode usar >
, >=
, <
e <=
para pesquisar valores que sejam maiores, maiores ou iguais, menores e menores ou iguais a outro valor.
Consulta | Exemplo |
---|---|
>n |
cats stars:>1000 corresponde a repositórios com a palavra "cats" que têm mais de 1.000 estrelas. |
>=n |
cats topics:>=5 corresponde a repositórios com a palavra "cats" que têm cinco tópicos ou mais. |
<n |
cats size:<10000 corresponde a código com a palavra "cats" em arquivos que têm menos de 10 KB. |
<=n |
cats stars:<=50 corresponde a repositórios com a palavra "cats" que têm até 50 estrelas. |
Você também pode usar consultas de intervalo para pesquisar valores que são maiores ou iguais ou menores ou iguais a outro valor.
Consulta | Exemplo |
---|---|
n..* |
cats stars:10..*
é equivalente a stars:>=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas. |
*..n |
cats stars:*..10
é equivalente a stars:<=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas. |
Consultar por valores dentro de um intervalo
You can use the range syntax n..n
to search for values within a range, where the first number n is the lowest value and the second is the highest value.
Consulta | Exemplo |
---|---|
n..n |
cats stars:10..50 corresponde a repositórios com a palavra "cats" que têm entre 10 e 50 estrelas. |
Consultar por datas
Você pode usar >
, >=
, <
, <=
e consultas de intervalo para pesquisar por datas anteriores ou posteriores a outra data ou que se enquadram em um intervalo de datas. Date formatting must follow the ISO8601 standard, which is YYYY-MM-DD
(year-month-day).
Consulta | Exemplo |
---|---|
>YYYY-MM-DD |
cats created:>2016-04-29 corresponde a problemas com a palavra "cats" que foram criados após 29 de abril de 2016. |
>=YYYY-MM-DD |
cats created:>=2017-04-01 corresponde a problemas com a palavra "cats" que foram criados após 01 de abril de 2017. |
<YYYY-MM-DD |
cats pushed:<2012-07-05 corresponde a código com a palavra "cats" em repositórios dos quais foi feito push antes de 05 de julho de 2012. |
<=YYYY-MM-DD |
cats created:<=2012-07-04 corresponde a problemas com a palavra "cats" que foram criados antes de 4 de julho de 2012. |
YYYY-MM-DD..YYYY-MM-DD |
cats pushed:2016-04-30..2016-07-04 corresponde a repositórios com a palavra "cats" nos quais foi feito push entre o final de abril e julho de 2016. |
YYYY-MM-DD..* |
cats created:2012-04-30..* corresponde a problemas criados após 30 de abril de 2012 contendo a palavra "cats". |
*..YYYY-MM-DD |
cats created:*..2012-04-30 corresponde a problemas criados antes de 4 de julho de 2012 contendo a palavra "cats". |
You can also add optional time information THH:MM:SS+00:00
after the date, to search by the hour, minute, and second. That's T
, followed by HH:MM:SS
(hour-minutes-seconds), and a UTC offset (+00:00
).
Consulta | Exemplo |
---|---|
YYYY-MM-DDTHH:MM:SS+00:00 |
cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00
corresponde a problemas criados entre 01 de janeiro de 2017 à 1h, com uma diferença de fuso horário de 07:00 em relação ao UTC, e 01 de março de 2017 às 15h, com uma diferença de fuso horário de 07:00 em relação ao UTC. |
YYYY-MM-DDTHH:MM:SSZ |
cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z corresponde a problemas criados entre 21 de março de 2016 às 14h11 e 07 de abril de 2106 às 20h45. |
Excluir determinados resultados
Usando a sintaxe NOT
, é possível excluir resultados contendo uma determinada palavra. O operador NOT
só pode ser usado para palavras-chave de string. Ele não funciona com numerais ou datas.
Consulta | Exemplo |
---|---|
NOT |
hello NOT world corresponde a repositórios que têm a palavra "hello", mas não a palavra "world". |
Outra maneira de restringir os resultados da pesquisa é excluir determinados subconjuntos. Adicione um prefixo a qualquer qualificador de pesquisa com um -
para excluir todos os resultados correspondentes a esse qualificador.
Consulta | Exemplo |
---|---|
-QUALIFIER |
cats stars:>10 -language:javascript corresponde a repositórios com a palavra "cats" que têm mais de 10 estrelas, mas não são escritos em JavaScript. |
mentions:defunkt -org:github corresponde a problemas mencionando @defunkt que não estão em repositórios na organização do GitHub. |
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 a repositórios com a palavra "cats", mas não as palavras "hello world".
- build label:"bug fix" corresponde a problemas com a palavra "build" que têm a etiqueta "bug fix".
Alguns símbolos não alfanuméricos, como espaços, são descartados de consultas de pesquisa de código entre aspas, por isso os resultados podem ser inesperados.