<a id="markdown-vanessa-runner" name="vanessa-runner"></a>

vanessa-runner

Консольная утилита для автоматизации повседневных операций разработчика 1С: сборка и разборка конфигураций, расширений и обработок, загрузка в базу, хранилище, кластер, запуск тестов (Vanessa-ADD, YAxUnit), проверка кода, MCP-сервер для ИИ-ассистентов.

📖 Документация: autumn-library.github.io/vanessa-runner

⚠️ vanessa-runner 3.0 — новая мажорная версия с несовместимыми изменениями. При переходе с 2.x см. руководство по миграции.

LTS-версия 2.x поддерживается в ветке release/2.6 — только исправления ошибок.

Установка

Требуется OneScript 2.0.0 или новее.

# Последняя стабильная версия
opm install vanessa-runner

# Snapshot-версия для тестирования
opm install vanessa-runner@SNAPSHOT

# LTS-версия 2.x
opm install vanessa-runner@2.6.1

Подробнее: Установка, Первые шаги.

Миграция с 2.x на 3.0

Что изменилось	Действие
Минимальная версия OneScript — 2.0.0	Обновить OneScript (ovm, oscript.io)
Команды сгруппированы: vrunner vanessa → vrunner test vanessa, vrunner updatedb → vrunner infobase update, vrunner syntax-check → vrunner validate syntax-check и т. д.	Переписать вызовы по таблице соответствия
Файл настроек vrunner.json → autumn-properties.json (иерархия команд, ключи без --)	Сконвертировать: oscript tools/migrate26to30.os --input vrunner.json --output autumn-properties.json (подробнее)
Переменные окружения RUNNER_* → VRUNNER_*	Переименовать в CI-файлах и скриптах

Пример файла настроек 3.0:

{
  "vrunner": {
    "ibconnection": "/F./build/ib",
    "v8version": "8.3.24",
    "test": {
      "xunit": {
        "testspath": "./tests",
        "report-format": ["junit"],
        "report-path": "./build/reports/junit.xml"
      }
    }
  }
}

Проблемы с миграцией — заводите issue.