Edt MCP Yaxunit

EDT-MCP — YAXUnit (1C unit tests)

YAXUnit is a unit-testing framework for 1C:Enterprise (Apache-2.0, bia-technologies). Tests are written in BSL, run by the platform via the RunUnitTests launch parameter, and produce a JUnit report. In this repo they run headless through the MCP tools run_yaxunit_tests / debug_yaxunit_tests.

Three pieces — without all three the tests do NOT run

Common mistake: install only the EDT plugin and expect run_yaxunit_tests to work. Without YAxUnit.cfe in the infobase the ЮТест engine doesn't resolve at runtime — the run gives an empty/error result.

Setup (one-time)

1. EDT plugin — install into EDT.
2. Engine into the infobase — load YAxUnit.cfe (releases) as an extension: Designer/EDT → Extensions → Add → pick the .cfe; in the extension properties clear "Safe mode" and "Protection from dangerous actions" (otherwise the ЮТест export methods are blocked). The configuration does NOT need to be taken off support. The MCP server has NO "attach extension" tool — a human does this (or DESIGNER /LoadCfg -Extension).
3. Test extension — create an EDT configuration-extension project (File → New → Configuration Extension Project) extending the target configuration.
   • Extension name = tests — then run_yaxunit_tests with no filter finds it via the default filter.extensions=["tests"]. Any other name means always passing extensions=["name"].
   • Prefix (namePrefix, e.g. tests_) — every native object of the extension must start with it.

Test-module structure

A test module is a native CommonModule in the test extension:

• Flags: Сервер=Истина (for server tests); NOT Глобальный, NOT ВызовСервера, no re-use. At least one context flag (Сервер or КлиентУправляемоеПриложение).
• The name starts with the extension prefix (e.g. tests_SampleTests).
• Registered in the extension's Configuration.mdo with <commonModules>CommonModule.tests_SampleTests</commonModules>.

Minimal module:

#Region Public

// YAXUnit finds the test module by the exported ИсполняемыеСценарии() and calls it
// to collect the test set. Each .ДобавитьТест("Method") = an exported procedure below.
Процедура ИсполняемыеСценарии() Экспорт
    ЮТТесты.ДобавитьТестовыйНабор("Arithmetic")
        .ДобавитьТест("TwoPlusTwoIsFour");
    // Parameterization: one method, several input sets.
    ЮТТесты.ДобавитьТестовыйНабор("Parameterized")
        .ДобавитьТест("SumByParameters")
            .СПараметрами(2, 3, 5)
            .СПараметрами(0, 0, 0);
КонецПроцедуры

// Hook — runs before each test of the module. Per-test scratch state lives in
// ЮТест.КонтекстТеста() (also КонтекстТестовогоНабора / КонтекстМодуля).
Процедура ПередКаждымТестом() Экспорт
    ЮТест.КонтекстТеста().Вставить("Started", Истина);
КонецПроцедуры

Процедура TwoPlusTwoIsFour() Экспорт
    ЮТест.ОжидаетЧто(2 + 2).Равно(4);
КонецПроцедуры

Процедура SumByParameters(First, Second, Expected) Экспорт
    ЮТест.ОжидаетЧто(First + Second).Равно(Expected);
КонецПроцедуры

#EndRegion

Other hooks (by name, all exported, optional): ПередВсемиТестамиМодуля / ПослеВсехТестовМодуля, ПередТестовымНабором / ПослеТестовогоНабора, ПередКаждымТестом / ПослеКаждогоТеста. Registration: .ДобавитьСерверныйТест / .ДобавитьКлиентскийТест for a specific context; .Тег("..."), .ВТранзакции() on a suite/test.

Asserts — ЮТест.ОжидаетЧто(value [, message])

Chain (each method takes an optional final parameter — the check description):

• equality/comparison: .Равно / .НеРавно / .Больше / .БольшеИлиРавно / .Меньше / .МеньшеИлиРавно;
• boolean/existence: .ЭтоИстина / .ЭтоЛожь / .Заполнено / .НеЗаполнено / .ЭтоНеопределено / .Существует;
• type: .ИмеетТип("Число") / .ИмеетТип(Тип("Строка"));
• strings: .Содержит / .НеСодержит / .НачинаетсяС / .ЗаканчиваетсяНа / .ИмеетДлину(N) / .СодержитСтрокуПоШаблону("regex");
• collections: .ИмеетДлину(N) / .Содержит(Элемент) / .КаждыйЭлементСодержитСвойство("X");
• navigation: .Свойство("Реквизит") / .Свойство("Товары[0].Номенклатура") / .Объект();
• exceptions: ЮТест.ОжидаетЧто(Модуль).Метод("Имя").Параметр(X).ВыбрасываетИсключение("fragment") (or .НеВыбрасываетИсключение()).

Unconditional: ЮТест.Упал("why"), ЮТест.Пропустить("reason"). The API is Russian-only (no English aliases).

Running through MCP

• run_yaxunit_tests — starts a run, polls up to timeout seconds, returns a JUnit-Markdown report (plus report.md/junit.xml on disk). Filters (arrays; families AND-combined, values within a family OR-ed): extensions, modules, tests (format Module.Method), tags. With no filter — default filter.extensions=["tests"]. tags selects by the YAXUnit tags declared with ЮТТесты.Тег(...) — module-, suite- or test-level, case-insensitive, no exclusion syntax.
• debug_yaxunit_tests — deprecated alias for run_yaxunit_tests(debug=true). It uses the same named-job path: a short start returns the launch handle; otherwise Pending returns jobId for get_job_status. When the handle arrives, call wait_for_break → get_variables / evaluate_expression / step / resume. Pin to one test (tests=["Module.Method"]) for predictability.