Кодемод grep: структурный поиск кода по публичным репозиториям GitHub

Codemod grep — это новый поисковик по коду, который работает на основе структуры, а не простого текста. Он использует синтаксис шаблонов ast-grep для сопоставления кода по его синтаксическому дереву, поэтому вы можете находить паттерны в публичных репозиториях GitHub, которые regex или текстовый поиск пропустили бы.

Что делает его особенным

Вместо поиска точных строк или нечетких regex-совпадений вы пишете шаблоны, которые представляют структуру кода. Например, шаблон console.log($MSG) будет соответствовать любому вызову console.log с любым аргументом. Аналогично, $A.$B($C) соответствует любому вызову метода на любом объекте с одним аргументом, а await $EXPR находит любое ожидаемое выражение.

Инструмент также поддерживает структурный поиск для HTML-шаблонов, например, поиск тегов <img> без атрибута alt — то, что сложно сделать с помощью regex, но тривиально при структурном сопоставлении.

Как использовать

Интерфейс прост: вы вводите шаблон ast-grep в поле поиска, при необходимости переключаетесь в режим YAML-правил для более сложных условий и нажимаете поиск. Также есть режим regex для традиционного строкового сопоставления и функция «Спросить ИИ» для запросов на естественном языке.

Внутри используется тот же синтаксис шаблонов, что и в CLI ast-grep, так что если вы уже умеете писать правила ast-grep, вы можете применить эти навыки здесь. Для быстрого старта на главной странице приведены примеры шаблонов: console.log($MSG), $A.$B($C) и await $EXPR.

Для кого это

Это будет полезно разработчикам, работающим с большими кодовыми базами, выполняющим межрепозиторный рефакторинг или аудит шаблонов кода в экосистеме открытого исходного кода. Это также отличный способ узнать, как те или иные API используются на практике.

Зайдите на grep.codemod.com, чтобы попробовать его со своими шаблонами.