Локальный запуск теста Vanessa add с генерацией отчета в Allure2
Разберем как запустить тест *.epf в конфигурации 1С на локальном ПК с генерацией отчета в Allure2 через собственный web-сервер.
№1Для начала необходимо установить программу тестирования через код "Vanessa add". Делается это либо через скачивание cmd:
opm install addУстанавливается пакет в папку C:\Program Files\OneScript\lib\add.
Либо можно вручную скачать архив с репозитория https://github.com/vanessa-opensource/add/releases/download/v6.8.0/add-6.8.0.zip
№2Теперь пишем в Конфигураторе 1С свой модульный тест, сохраняем его как *.epf и закидываем в удобную папку. Например в корне папки "add" (я ее переименовал в "add-6.8.0") есть папка "tests". Полный путь до конечной папки, где я размеcтил свой тест *.epf у меня следующий: "add-6.8.0\tests\xunit\Тесты" (в пункте №4 увидите настройку до этой папки в файле "vrunner.json").
№3Теперь можем перейти к установке фреймворка "Allure2", который будет надстройкой над "Vanessa add" для формирования отчета о результатах тестирования. Скачиваем архив https://github.com/allure-framework/allure2/releases/download/2.21.0/allure-2.21.0.zip и распаковываем в удобную папку (лучше поближе к "add-6.8.0"). Для запуска исполняемого allure.bat, теперь нужно добавить окружение (Windows) в переменную "Path" -> путь до папки "bin", в моем случае этот путь "C:\Users\User\Documents\allure-2.21.0\bin":
Если выполнить запрос в cmd:
where allure
И вернется:
C:\Users\User\Documents\allure-2.21.0\bin\allure C:\Users\User\Documents\allure-2.21.0\bin\allure.batТогда все сделали верно, allure2 установлен.
№4Теперь можно приступать к настройке "Vanessa add", чтобы можно было запустить тест и посмотреть по нему отчет. Перед этим создадим папки "allure-report", "allure-results" в корне "add-6.8.0":
"allure-report" - здесь генерируется отчет;
"allure-results" - здесь хранится результат, выводимый в html браузера.
Для удобства следует установить программу "Visual Studio Code" (скачиваем с https://code.visualstudio.com/). Открываем "Visual Studio Code" и заходим в папку ".\add-6.8.0\tools\json\" и открываем файл настройки "vrunner.json". Для настройки Allure2 нас интересует раздел "xunit" с настройкой папок: откуда запускать тестовые файлы *.epf и куда генерировать файлы *.json с отчетом:
"--reportsxunit": "ГенераторОтчетаAllureXMLВерсия2{allure-report/}",
"testsPath": "./tests/xunit/Тесты"
№5Теперь осталось запустить наш тест из папки "add-6.8.0\tests\xunit\Тесты" и сформировать отчет тестирования. Для удобства выполнения, в папке "add-6.8.0\tools" я создал запускные файлы *.cmd для запуска теста и генерации отчета:
run_tests.cmd:
@chcp 65001 @call allure generate --clean .\allure-report @call vrunner xunit --settings ./tools/json/vrunner.json
gen_allure_report.cmd:
@call allure generate --clean .\allure-report -o .\allure-results @call allure open .\allure-resultsДанные скрипты прикладываю в конце статьи. Немного слов про то, что выполняют эти команды:
То данную строку можно удалить или закомментировать. Так же, если нужно каждый раз видеть предыдущие запуски других тестов (если меняется кол-во тестов в *.epf в "add-6.8.0\tests\xunit\Тесты"), то можно так же удалить это очищение перед запуском каждого теста. Лично мне, нравится видеть всегда новый результат, т.к. кол-во тестов постоянно меняется в моей папке с тестами. Следующей командой vrunner xunit я запускаю все тесты из папки указанной в "vrunner.json".
"gen_allure_report.cmd"- Перед генерацией отчета из папки .\allure-report очищается (удаляется) папка с результатами (прошлыми) тестирования из папки .\allure-results и генерируется новый результат, который затем автоматически открывается в браузере.Запускаю скрипты путем перетаскивания курсором в "Терминал" visual studio code:
Таким образом, поочередно запуская данные скрипты, мы каждый раз будем сначала запускать тесты из папки где они расположены, затем выводить отчет через стартуемый локальный web-сервер Allure2:
