Skip to main content

Compréhension de la syntaxe de recherche

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

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ête Exemple
>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ête Exemple
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ête Exemple
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ête Exemple
>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 au code contenant le mot « cats » dans les dépôts qui ont été envoyé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 après le 30 avril 2012, contenant le mot « cats ».
*..YYYY-MM-DDcats created:*..2012-07-04 correspond aux problèmes créés avant le 4 juillet 2012, 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ête Exemple
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 certains résultats

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ête Exemple
NOThello NOT world correspond aux dépôts contenant le mot « hello », mais pas le mot « world ».

Une autre façon de limiter les résultats de recherche consiste à exclure certains sous-ensembles. Vous pouvez préfixer n’importe quel qualificateur de recherche avec un signe - afin d’exclure tous les résultats correspondant à ce qualificateur.

Requête Exemple
-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.
mentions:defunkt -org:github correspond aux problèmes indiquant @defunkt, qui ne figurent pas dans des dépôts au sein de l’organisation GitHub

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 AE pour spécifier une personne spécifique, ou @me, pour spécifier l’utilisateur actuel.

Requête Exemple
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.