Codemod grep: Strukturelle Codesuche über öffentliche GitHub-Repos

Codemod grep ist eine neue Codesuchmaschine, die auf Struktur statt auf reinem Text basiert. Sie verwendet die ast-grep-Mustersyntax, um Code anhand seiner Syntaxbaumform zu matchen, sodass Sie Muster in öffentlichen GitHub-Repositories finden können, die Regex- oder Textsuche übersehen würden.

Was es anders macht

Statt nach exakten Zeichenfolgen oder vagen Regex-Treffern zu suchen, schreiben Sie Muster, die Codestruktur repräsentieren. Zum Beispiel matcht das Muster console.log($MSG) jeden console.log-Aufruf mit beliebigem Argument. Ebenso matcht $A.$B($C) jeden Methodenaufruf auf einem Objekt mit einem Argument, und await $EXPR findet jeden Ausdruck mit await.

Das Tool unterstützt auch strukturelle Suche für HTML-Muster, wie das Finden von <img>-Tags ohne alt-Attribut – etwas, das mit Regex schwierig, aber mit strukturellem Matching trivial ist.

So verwenden Sie es

Die Oberfläche ist einfach: Sie geben ein ast-grep-Muster in das Suchfeld ein, optional wechseln Sie in den YAML-Regelmodus für komplexere Bedingungen, und klicken auf Suchen. Es gibt auch einen Regex-Modus für traditionelle String-Suche und eine "Ask AI"-Funktion für natürliche Sprachabfragen.

Im Hintergrund verwendet es exakt dieselbe Mustersyntax wie die ast-grep-CLI. Wenn Sie also bereits wissen, wie man ast-grep-Regeln schreibt, können Sie diese Fähigkeiten hier nutzen. Für einen Schnellstart bietet die Startseite Beispielmuster wie console.log($MSG), $A.$B($C) und await $EXPR.

Für wen es gedacht ist

Das wird Entwickler ansprechen, die an großen Codebasen arbeiten, repository-übergreifendes Refactoring durchführen oder Codemuster im Open-Source-Ökosystem überwachen müssen. Es ist auch eine großartige Möglichkeit, herauszufinden, wie bestimmte APIs in der Praxis verwendet werden.

Gehen Sie zu grep.codemod.com, um es mit Ihren eigenen Mustern auszuprobieren.