ColGrep 1.8.4: локальный поиск точнее показывает место в коде

Что стало понятнее в результатах поиска?

ColGrep строит локальный индекс — карту файлов проекта, которая помогает искать не только точное слово, но и смысл запроса. Раньше результат вроде file:12-480 мог охватывать сразу много строк из-за нескольких совпадений в одном файле. Версия 1.8.4 выводит подходящие фрагменты по отдельности, сначала самые релевантные, не более трёх на файл. Если фрагмент — функция, метод или класс, рядом показывается имя; у обычного текста имени может не быть. Это изменение формата выдачи, а не доказательство, что сама модель поиска стала точнее. s2 s3

Например, на вопрос «где обрабатывается ошибка соединения?» ожидайте пути вида папка/файл:начало-конец ИмяФункции. Имя помогает сразу решить, какую функцию открыть. Это пример того, как читать выдачу, а не результат нашего запуска или гарантия, что нужная функция будет найдена в любом проекте. s2 s3

Нужно ли обновляться?

Если ColGrep уже установлен и в поиске по большим файлам вы получаете слишком длинные диапазоны, версия 1.8.4 может упростить переход к нужному месту. Возьмите сборку для своей ОС с официальной страницы релиза: там опубликованы варианты для macOS, Windows и Linux. В папке собственного проекта выполните colgrep init, затем, например, colgrep "where are retries configured". После построения индекса появятся пути и диапазоны строк; сравните их с известной вам функцией. Команды и вид вывода сверены по документации, но редакция не запускала эту версию на реальном проекте. s1 s3

Есть и отдельные изменения для опытных пользователей: при передаче вывода в закрывшийся конвейер программа больше не должна аварийно завершаться; режим --agent теперь возвращает местоположения вместе с кодом охватывающей функции. Режим агента использует другую загружаемую модель и не нужен для обычного поиска. У её опубликованной карточки нет явной лицензии на веса, поэтому мы не переносим Apache-2.0 лицензию кода ColGrep на эту модель и не рекомендуем её установку как необходимый шаг. Заявления о поведении релиза — по исходному коду и описанию авторов, а не наши измерения. s2 s4 s5

Следующий шаг: если вы впервые знакомитесь с программой, начните с обзора ColGrep 1.8.2 о поиске по разным типам файлов; затем проверьте 1.8.4 на одном знакомом участке своего проекта. s1 s3