Мажорный релиз. vanessa-runner полностью переписан на Осень
📖 Документация: autumn-library.github.io/vanessa-runner
Установка
opm install vanessa-runnerТребуется OneScript 2.0.0 или новее. Вместе с пакетом ставятся vrunner (синоним vanessa-runner) и vrunner-mcp. Обработки Vanessa-ADD для test xunit и test vanessa ставятся отдельно: opm install add.
⚠️ Breaking changes
3.0 несовместим с 2.x: изменились состав и структура команд (vrunner xunit → vrunner test xunit), формат и имя файла настроек (vrunner.json → autumn-properties.json), префикс переменных окружения (RUNNER_* → VRUNNER_*), минимальная версия OneScript (2.0.0). Скрипты и CI-пайплайны 2.x без правок не заработают!
Порядок перехода, таблица соответствия команд, страницы «было → стало» для каждой команды 2.x и скрипт конвертации файла настроек — в руководстве по миграции.
Если переход откладывается, оставайтесь на LTS-ветке: opm install vanessa-runner@2.6.1. Ветка release/2.6 получает только исправления ошибок.
🆕 Что нового
- Новый подход к группировке команд - команды сгруппированы по блокам: Для работы с конфигурацией
vrunner cf, с расширениямиvrunner cfe, Для того чтобы что-то сделать с информационной базой(обновить, выгрузить дт и тд)vrunner infobase. - Проекты 1С:EDT понимаются из коробки. Больше не нужно вручную гонять
1cedtcli exportперед сборкой: любой команде, которая работает с исходниками, можно отдать каталог EDT-проекта, и vrunner сам разберётся, что это, и сконвертирует в нужную сторону. Разобрать.cfсразу в EDT-проект тоже можно. Для тех, кому нужна только конвертация, естьcf convert,cfe convertиepf convert— без базы и без сборки. - Тесты YAxUnit запускаются одной командой.
test yaxunitсобирает файл запуска, поднимает клиент, дожидается результата, печатает сводку в консоль и падает с ненулевым кодом, если тесты не прошли. Можно ограничить прогон расширением, модулем, тегом или конкретным тестом. - Покрытие кода тестами — одной опцией. Добавьте
--coverage-report ./build/coverage.xmlкtest xunit,test yaxunitилиtest vanessa— vrunner сам поднимет сервер отладки, снимет исполненные строки, сопоставит их с исходниками и посчитает процент. Отчёт понимают SonarQube, GitLab и Jenkins. Работает и для серверных баз, если сервер отладки доступен кластеру. - vrunner для ИИ-агентов. Вместе с пакетом ставится
vrunner-mcp— MCP-сервер, через который Claude Code, Cursor, VS Code и другие клиенты видят команды vrunner как инструменты. Достаточно сказать «собери конфигурацию изsrc» — ассистент подберёт команду и параметры. Долгие операции идут в фоне, строка подключения и версия платформы запоминаются на сессию. - База из репозитория — одной командой.
infobase initсоздаёт базу, грузит в неё конфигурацию из исходников,.cfили.dtи сразу расширения. С--recursiveне нужно перечислять пути: конфигурация и расширения находятся по каталогам проекта сами. - Инкрементальная загрузка. С
--incrementв базу попадают только файлы, изменённые с прошлого запуска; для EDT-проектов — только изменённые объекты. Если ничего не менялось, загрузка пропускается. Ежедневное обновление базы разработчика становится в разы быстрее. - Исходники прямо из базы.
cf decompileиcfe decompileбез указания файла выгружают конфигурацию или установленное расширение из базы--ibconnection— в XML или сразу в EDT. - Обновление типовой конфигурации на поддержке.
cf vendor-update— аналогvrunner updateиз 2.x: применяет.cfuили.cfпоставщика с сохранением доработок. В имени файла работает шаблон$version— берётся старшая версия из каталога. - Синтаксическая проверка расширений.
validate syntax-check --targetвыбирает, что проверять: основную конфигурацию, все расширения или конкретное. Без опции проверяется всё.--groupbymetadataсобирает замечания по объектам, чтобы отчёт читался, а не превращался в тысячу строк. - Сеансы кластера под контролем.
cluster session listпоказывает, кто сидит в базе и зависшие соединения без сеанса.session killтеперь проверяет, что сеансы действительно завершились, и добивает зависшие.session closed --timeoutумеет подождать, пока фоновые задания сами доработают перед обновлением. Отборы по приложению и пользователю задаются явными опциями. - Автономный сервер стал надёжнее. Можно подключиться к уже запущенному ibsrv, а не поднимать свой. Устранена гонка портов при параллельных запусках.
- Один файл настроек на проект.
autumn-properties.jsonзадаёт значения для всех команд сразу, для группы или для конкретной команды. - Личные настройки отдельно от проектных. Есть возможность определить настройки для проекта в целом(и положить их в индекс), а потом обогатить их файлом личных настроек разработчика используя ключ settings
- Подсказки в редакторе для файла настроек. К релизу прилагается JSON Schema: пропишите
$schemaвautumn-properties.json, и VS Code подскажет ключи, типы и допустимые значения. - Лог отдельно от данных. Ключ
log-output: stderrуводит лог в stderr, это полезно на ci для отделения информации возвращаемой командой от логов. - Справка стала актуальной.
vrunner cf compile --helpспасибо autumn-cli, за это. Все аргументы обладают исчерпывающим описанием - Новый портал с документацией Документация проекта доступна по ссылке! Там можно найти примеры использования, информацию и тд и тп.
Full Changelog: v2.6.1...v3.0.0