vanessa-opensource/vanessa-runner v3.0.0

vanessa-runner 3.0.0

on GitHub

Мажорный релиз. 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