Codemod grep: Busca estrutural de código em repositórios públicos do GitHub

Codemod grep é um novo mecanismo de busca de código que funciona por estrutura, em vez de texto simples. Ele usa a sintaxe de padrões do ast-grep para corresponder ao código pela forma da árvore sintática, permitindo encontrar padrões em repositórios públicos do GitHub que regex ou busca por texto não capturariam.

O que o torna diferente

Em vez de procurar strings exatas ou correspondências regex difusas, você escreve padrões que representam a estrutura do código. Por exemplo, o padrão console.log($MSG) corresponderá a qualquer chamada console.log com qualquer argumento. Da mesma forma, $A.$B($C) corresponde a qualquer chamada de método em qualquer objeto com um único argumento, e await $EXPR encontra qualquer expressão aguardada.

A ferramenta também suporta busca estrutural para padrões HTML, como encontrar tags <img> sem atributo alt — algo complicado com regex, mas trivial com correspondência estrutural.

Como usar

A interface é simples: você insere um padrão ast-grep na caixa de busca, opcionalmente alterna para o modo de regras YAML para condições mais complexas, e clica em buscar. Há também um modo regex para correspondência tradicional de strings e um recurso "Perguntar à IA" para consultas em linguagem natural.

Nos bastidores, ele utiliza exatamente a mesma sintaxe de padrões usada pela CLI do ast-grep, então, se você já sabe escrever regras ast-grep, pode reutilizar essas habilidades aqui. Para começar rapidamente, a página inicial oferece exemplos de padrões como console.log($MSG), $A.$B($C) e await $EXPR.

Para quem é

Isso atrairá desenvolvedores que trabalham em grandes bases de código, realizam refatoração entre repositórios ou precisam auditar padrões de código em todo o ecossistema de código aberto. Também é uma ótima maneira de descobrir como certas APIs são usadas na prática.

Acesse grep.codemod.com para experimentar com seus próprios padrões.