vanessa-runner

⚠️ vanessa-runner 3.0 — новая мажорная версия содержит BREAKING CHANGES. При переходе с 2.x обязательно ознакомьтесь с руководством по миграции.(Пока в разработке)

Стабильная LTS-версия 2.x продолжает поддерживаться в ветке release/2.6 — там выпускаются только багфиксы.

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

---

Установка

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

# Конкретная snapshot-версия для тестирования
opm install vanessa-runner@snapshot

# LTS-версия 2.x (рекомендуется для production до стабилизации 3.0)
opm install vanessa-runner@2.6.1

---

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

vanessa-runner 3.0 содержит ряд изменений. Подробное руководство со всеми деталями — на сайте документации. Ниже — краткое резюме.

TL;DR — что менять

Что изменилось	Действие
Минимальная версия OneScript	Обновить OneScript до версии 2.0.0+
Состав команд vrunner	Заменить переименованные/удалённые команды
Формат vrunner.json	Привести файл настроек к новой схеме
Имена переменных окружения	Переименовать RUNNER_* в VRUNNER_*

---

1. Повышена минимальная версия OneScript

Для работы 3.0 требуется OneScript не ниже 2.0.0 (в 2.x минимальная была 1.9.2).

# Проверить текущую версию
oscript -version

Обновить OneScript можно через ovm или установив свежий пакет с oscript.io.

2. Изменения в командах vrunner

Часть команд переименована, часть удалена. Полная таблица — в migration guide.

Было (2.x)	Стало (3.0)	Комментарий
vrunner vanessa	vrunner test vanessa	переименована
vrunner updatedb	vrunner infobase update	функционал обновления ИБ консолидирован в новой команде
vrunner syntax-check	vrunner validate syntax-check	изменён набор ключей

3. Изменён формат vrunner.json

Структура файла настроек обновлена. При запуске со старым форматом vrunner выведет ошибку с указанием, какие ключи нужно поправить.

Было (2.x) — плоский vrunner.json с ключами в формате --ключ:

{
  "default": {
    "--ibconnection": "/F./build/ib",
    "--v8version": "8.3.24"
  },
  "xunit": {
    "--reportsxunit": "jUnit{./build/reports/junit.xml}"
  },
  "vanessa": {
    "--vanessasettings": "./tools/.vb-conf.json"
  }
}

Стало (3.0) — иерархический autumn-properties.json без -- в ключах:

{
  "runner": {
    "ibconnection": "/F./build/ib",
    "v8version": "8.3.24",
    "test": {
      "xunit": {
        "reportsxunit": "jUnit{./build/reports/junit.xml}"
      },
      "vanessa": {
        "vanessasettings": "./tools/.vb-conf.json"
      }
    }
  }
}

💡 Автоматическая конвертация vrunner.json → autumn-properties.json планируется в одном из ближайших релизов 3.0. До тех пор выполните миграцию вручную по таблице выше.

4. Переименованы переменные окружения

Переменные окружения RUNNER_* переименованы для устранения конфликтов с CI-окружениями (GitHub Actions, GitLab Runner и др., где RUNNER_* зарезервированы системой).

⚠️ Не забудьте поправить определения переменных в .gitlab-ci.yml, GitHub workflow-файлах, Jenkinsfile и shell-скриптах сборки.

---

Откат на 2.x

Если миграция занимает время — оставайтесь на LTS:

opm install vanessa-runner@2.6.1

Ветка release/2.6 продолжает получать багфиксы.

Помощь

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