Codemod grep : recherche structurelle de code dans les dépôts GitHub publics

Codemod grep est un nouveau moteur de recherche de code qui fonctionne sur la structure plutôt que sur le texte brut. Il utilise la syntaxe des motifs ast-grep pour faire correspondre le code par la forme de son arbre syntaxique, ce qui vous permet de trouver des motifs dans les dépôts GitHub publics que la recherche par texte ou par regex manquerait.

Ce qui le rend différent

Au lieu de rechercher des chaînes exactes ou des correspondances floues par regex, vous écrivez des motifs qui représentent la structure du code. Par exemple, le motif console.log($MSG) correspondra à tout appel console.log avec n'importe quel argument. De même, $A.$B($C) correspond à tout appel de méthode sur n'importe quel objet avec un seul argument, et await $EXPR trouve toute expression attendue.

L'outil prend également en charge la recherche structurelle pour les motifs HTML, comme trouver les balises <img> sans attribut alt — ce qui est délicat avec les regex mais trivial avec la correspondance structurelle.

Comment l'utiliser

L'interface est simple : vous entrez un motif ast-grep dans la zone de recherche, vous passez éventuellement en mode règle YAML pour des conditions plus complexes, et vous lancez la recherche. Il existe également un mode regex pour la correspondance de chaînes traditionnelle, et une fonctionnalité « Ask AI » pour les requêtes en langage naturel.

Sous le capot, il utilise exactement la même syntaxe de motif que celle utilisée par le CLI d'ast-grep, donc si vous savez déjà écrire des règles ast-grep, vous pouvez réutiliser ces compétences ici. Pour un démarrage rapide, la page d'accueil propose des exemples de motifs comme console.log($MSG), $A.$B($C), et await $EXPR.

À qui cela s'adresse

Cela plaira aux développeurs qui travaillent sur de grandes bases de code, effectuent des refactorisations inter-dépôts, ou ont besoin d'auditer des motifs de code dans l'écosystème open-source. C'est aussi un excellent moyen de découvrir comment certaines API sont utilisées en pratique.

Rendez-vous sur grep.codemod.com pour essayer avec vos propres motifs.