1c-platform-tools-test

name	1c-platform-tools-test
description	Тестирование 1С. Используй, когда пользователь просит запустить тесты, XUnit, Vanessa, синтаксический контроль, построить Allure-отчёт.

Тестирование: команды и MCP

Выполняй запуск тестов и отчётов через команды расширения или инструменты MCP. Выполняй команду сам (Execute Command или MCP), не проси пользователя нажимать палитру.

Когда вызывать

Запрос пользователя (примеры)	Действие
Запусти тесты, XUnit, Vanessa	test_xunit / test_vanessa или команда
Синтаксический контроль	test_syntaxCheck или команда
Построй Allure-отчёт	test_allure или команда
Собери/разбери unit тесты (.epf)	команда buildEpf / decompileEpf

Команды расширения

Задача	Command ID
XUnit тесты	1c-platform-tools.test.xunit
Синтаксический контроль	1c-platform-tools.test.syntaxCheck
Vanessa тесты	1c-platform-tools.test.vanessa
YAxUnit тесты	1c-platform-tools.test.yaxunit
Allure отчёт	1c-platform-tools.test.allure
Собрать unit тесты	1c-platform-tools.test.buildEpf
Разобрать unit тесты	1c-platform-tools.test.decompileEpf
Запустить EPF в Предприятии	1c-platform-tools.enterprise.run
Настроить тестовые фреймворки	1c-platform-tools.testing.configure

Сборка/разборка unit тестов (тестовых обработок 1С): исходники в src/tests (настройка paths.testsSrc), собранные .epf — в build/out/tests (артефакт, в git не попадает). В tests — скриптовые .os-тесты OneScript; дымовые наборы Vanessa-ADD поставляются в пакете add (oscript_modules). Обе команды поддерживают wait: true.

Панель тестирования VS Code

Тесты также отображаются в нативной панели «Тестирование» (Test Explorer): Vanessa (.feature), xUnit (тестовые обработки в src/tests), YAxUnit, OneScript (.os в tests), 1bdd — с запуском отдельных тестов и статусами. Для интерактивной работы пользователя направляй туда; команды выше — для прогона «всего сразу» и агентных циклов.

Запуск обработок в Предприятии (enterprise.run)

Служебные шаги (загрузка фикстур, инициализация ИБ внешней обработкой) — Execute Command 1c-platform-tools.enterprise.run с аргументом (в схеме MCP параметров execute/command нет):

{ "execute": "./build/out/epf/ЗагрузкаФикстур.epf",
  "command": "Путь=./fixtures/Константы.xml;ЗавершитьРаботуСистемы",
  "wait": true }

execute — путь к EPF/ERF, command — строка параметров /C; нужен хотя бы один из них.

Настройка фреймворков (testing.configure)

Неинтерактивно — Execute Command 1c-platform-tools.testing.configure с аргументом { "frameworks": [...], "wait": true } (ключи: vanessa, xunit, yaxunit, onescript, onebdd; перечисленные включаются, остальные выключаются, недостающие каталоги создаются).

Агентный вызов без frameworks вернёт ошибку с подсказкой, окно не откроется. Интерактивный визард доступен только пользователю из палитры.

MCP (mcp-1c-platform-tools)

Если доступны инструменты MCP, используй их: test_xunit, test_syntaxCheck, test_vanessa, test_allure.

Параметр projectPath

Обязательный. Корень проекта 1С (каталог с packagedef). Если пользователь указал путь — используй его; иначе корень workspace.

Параметр settingsFile

Файл настроек vanessa-runner относительно projectPath; перекрывает активный профиль для конкретного вызова. Используй, когда нужен другой набор сценариев или другая ИБ без переключения профиля (например, init-профиль tools/vrunner.init.json вместо основного env.json).

Параметр wait

wait: true — ждать завершения операции и получить структурированный результат:

{
  success: boolean,   // true = exitCode 0
  exitCode: number,
  stdout: string,     // вывод vrunner (прогресс, найденные ошибки)
  stderr: string
}

Когда использовать wait: false (по умолчанию): запуск из UI — пользователь видит ход выполнения в терминале. Используй для интерактивного запуска без ожидания.

Когда использовать wait: true: автономный агентный цикл — агент читает success, exitCode, stdout/stderr и решает, что делать дальше.

Поддержка wait: true (тесты)

MCP-инструмент	wait: true
test_syntaxCheck	✅
test_xunit	✅
test_vanessa	✅
test_allure	❌ (открывает браузер)

Примеры

• Синхронная проверка синтаксиса (агентный цикл):

  test_syntaxCheck { projectPath: "C:/projects/MyProject", wait: true }
  

  → вернёт { success: false, exitCode: 1, stdout: "ОШИБКА - ...", stderr: "" }

• Запуск синтакс-проверки из UI (пользователь видит терминал):

  test_syntaxCheck { projectPath: "C:/projects/MyProject" }
  

  → вернёт подсказку использовать wait: true для получения результата

• Выполни команду 1c-platform-tools.test.xunit для запуска XUnit-тестов текущего проекта.

• Вызови MCP test_vanessa с projectPath = корень проекта 1С.