Compréhension de la syntaxe de recherche

Lors de la recherche dans GitHub Enterprise Server, vous pouvez construire des requêtes qui correspondent à des nombres et des mots spécifiques.

Dans cet article

Requête de valeurs supérieures ou inférieures à une autre valeur

Vous pouvez utiliser >, >=, < et <= pour rechercher des valeurs supérieures, supérieures ou égales, inférieures, et inférieures ou égales à une autre valeur.

RequêteExemple
>ncats stars:>1000 correspond aux dépôts contenant le mot «cats » qui ont plus de 1 000 étoiles.
>=ncats topics:>=5 correspond aux dépôts contenant le mot «cats » qui ont au minimum 5 rubriques.
<ncats size:<10000 correspond au code contenant le mot « cats » dans des fichiers d’une taille inférieure à 10 Ko.
<=ncats stars:<=50 correspond aux dépôts contenant le mot «cats » qui ont au maximum 50 étoiles.

Vous pouvez également utiliser des requêtes de plage pour rechercher des valeurs supérieures ou égales, ou inférieures ou égales à une autre valeur.

RequêteExemple
n..*cats stars:10..* équivaut à stars:>=10 et correspond à des dépôts contenant le mot « cats » qui ont au minimum 10 étoiles.
*..ncats stars:*..10 équivaut à stars:<=10 et correspond à des dépôts contenant le mot « cats » qui ont au maximum 10 étoiles.

Requête de valeurs comprises dans une plage

Vous pouvez utiliser la syntaxe de plage n..n pour rechercher des valeurs dans une plage, où le premier nombre N est la valeur la plus basse, et le second la valeur la plus élevée.

RequêteExemple
n..ncats stars:10..50 correspond aux dépôts contenant le mot «cats » qui ont entre 10 et 50 étoiles.

Requête de dates

Vous pouvez rechercher des dates antérieures ou postérieures à une autre date, ou qui s’inscrivent dans une plage de dates, en utilisant >, >=, <, <= et des requêtes de plage. La mise en forme de la date doit respecter la norme ISO8601, à savoir YYYY-MM-DD (année, mois, jour).

RequêteExemple
>YYYY-MM-DDcats created:>2016-04-29 correspond aux problèmes liés au mot « cats » qui ont été créés après le 29 avril 2016.
>=YYYY-MM-DDcats created:>=2017-04-01 correspond aux problèmes liés au mot « cats », qui ont été créés à partir du 1 avril 2017.
<YYYY-MM-DDcats pushed:<2012-07-05 correspond aux dépôts contenant le mot « cats » qui ont été poussés (push) avant le 5 juillet 2012.
<=YYYY-MM-DDcats created:<=2012-07-04 correspond aux problèmes liés au mot « cats », qui ont été créés jusqu’au 4 avril 2012.
YYYY-MM-DD..YYYY-MM-DDcats pushed:2016-04-30..2016-07-04 correspond aux dépôts contenant le mot « cats » qui ont été envoyés (push) jusqu’à la fin des mois d’avril et de juillet 2016.
YYYY-MM-DD..*cats created:2012-04-30..* correspond aux problèmes créés le 30 avril 2012 ou après cette date, contenant le mot « cats ».
*..YYYY-MM-DDcats created:*..2012-07-04 correspond aux problèmes créés le 4 juillet 2012 ou avant cette date, contenant le mot « cats ».

Vous pouvez également ajouter des informations facultatives d’heure THH:MM:SS+00:00 après la date, pour rechercher par heure, minute et seconde. Il s’agit de T, suivi de HH:MM:SS (heures-minutes-secondes) et d’un décalage UTC (+00:00).

RequêteExemple
YYYY-MM-DDTHH:MM:SS+00:00cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 correspond aux problèmes créés entre le 1 janvier 2017 à 1 h avec un décalage UTC de 07:00 et le 1 mars 2017 à 15 h. avec un décalage UTC de 07:00.
YYYY-MM-DDTHH:MM:SSZcats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z correspond aux problèmes créés entre le 21 mars 2016 à 14h11 et le 7 avril 2016 à 20h45.

Exclure les résultats qui correspondent à un qualificateur

Vous pouvez affiner les résultats de la recherche en excluant un ou plusieurs sous-ensembles. Pour exclure tous les résultats correspondant à un qualificateur, préfixez n’importe quel qualificateur de recherche avec un tiret (-).

RequêteExemple
-QUALIFIERcats stars:>10 -language:javascript correspond aux dépôts contenant le mot « cats », qui ont plus de 10 étoiles mais ne sont pas écrits en JavaScript.
-QUALIFIERmentions:defunkt -org:github correspond aux problèmes indiquant @defunkt qui ne figurent pas dans des dépôts au sein de l’organisation GitHub.

Exclure des résultats avec des mots clés spécifiques

Vous pouvez exclure des résultats contenant un certain mot à l’aide de la syntaxe NOT. L’opérateur NOT ne peut être utilisé que pour des mots clés de type chaîne. Il ne fonctionne pas pour des chiffres ou des dates.

RequêteExemple
NOThello NOT world correspond aux dépôts contenant le mot « hello », mais pas le mot « world ».

Utiliser des guillemets pour les requêtes contenant un espace blanc

Si votre requête de recherche contient un espace blanc, vous devez l’entourer de guillemets. Par exemple :

  • cats NOT "hello world" correspond aux dépôts contenant le mot « cats » mais pas les mots « hello world ».
  • build label:"bug fix" correspond aux problèmes liés au mot « build », qui ont l’étiquette « bug fix ».

Certains symboles non alphanumériques, tels que les espaces, étant supprimés des requêtes de recherche de code entre guillemets, les résultats peuvent être inattendus.

Requêtes avec des noms d’utilisateur

Si votre requête de recherche contient un qualificateur qui exige un nom d’utilisateur, tel que user, actor ou assignee, vous pouvez utiliser n’importe quel nom d’utilisateur GitHub Enterprise Server pour spécifier une personne spécifique, ou @me, pour spécifier l’utilisateur actuel.

RequêteExemple
QUALIFIER:USERNAMEauthor:nat correspond aux validations créées par @nat
QUALIFIER:@meis:issue assignee:@me correspond aux problèmes attribués à la personne qui affiche les résultats

Vous ne pouvez utiliser @me qu’avec un qualificateur, et non comme un terme de recherche tel que @me main.workflow.