Codemod grep: Búsqueda estructural de código en repositorios públicos de GitHub

Codemod grep es un nuevo motor de búsqueda de código que funciona sobre la estructura en lugar de texto plano. Utiliza la sintaxis de patrones de ast-grep para coincidir con el código mediante la forma de su árbol sintáctico, por lo que puedes encontrar patrones en repositorios públicos de GitHub que las búsquedas por regex o texto pasarían por alto.

Qué lo hace diferente

En lugar de buscar cadenas exactas o coincidencias difusas con regex, escribes patrones que representan la estructura del código. Por ejemplo, el patrón console.log($MSG) coincidirá con cualquier llamada a console.log con cualquier argumento. De manera similar, $A.$B($C) coincide con cualquier llamada a un método sobre cualquier objeto con un solo argumento, y await $EXPR encuentra cualquier expresión con await.

La herramienta también admite búsqueda estructural para patrones HTML, como encontrar etiquetas <img> sin atributo alt — algo difícil con regex pero trivial con coincidencia estructural.

Cómo usarlo

La interfaz es simple: introduces un patrón de ast-grep en el cuadro de búsqueda, opcionalmente cambias al modo de reglas YAML para condiciones más complejas, y pulsas buscar. También hay un modo regex para la coincidencia tradicional de cadenas, y una función "Ask AI" para consultas en lenguaje natural.

Internamente, utiliza exactamente la misma sintaxis de patrones que usa el CLI de ast-grep, así que si ya sabes escribir reglas de ast-grep, puedes reutilizar esas habilidades aquí. Para un inicio rápido, la página de inicio ofrece ejemplos de patrones como console.log($MSG), $A.$B($C) y await $EXPR.

Para quién es

Esto atraerá a desarrolladores que trabajan en bases de código grandes, realizan refactorizaciones entre repositorios, o necesitan auditar patrones de código en el ecosistema de código abierto. También es una excelente manera de descubrir cómo se utilizan ciertas APIs en la práctica.

Ve a grep.codemod.com para probarlo con tus propios patrones.