https://github.com/artbear/1testrunner
Юнит-тестирование для OneScript
https://github.com/artbear/1testrunner
junit-xml oscript testing unit-testing
Last synced: 4 months ago
JSON representation
Юнит-тестирование для OneScript
- Host: GitHub
- URL: https://github.com/artbear/1testrunner
- Owner: artbear
- Created: 2016-08-12T19:38:02.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2025-02-12T07:32:30.000Z (4 months ago)
- Last Synced: 2025-02-12T08:44:54.638Z (4 months ago)
- Topics: junit-xml, oscript, testing, unit-testing
- Language: 1C Enterprise
- Homepage: https://oscript.io
- Size: 183 KB
- Stars: 7
- Watchers: 6
- Forks: 11
- Open Issues: 14
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
[](https://sonar.openbsl.ru/dashboard?id=1testrunner)
[](https://sonar.openbsl.ru/dashboard?id=1testrunner)
[](https://sonar.openbsl.ru/dashboard?id=1testrunner)
[](https://github.com/artbear/1testrunner/releases)
[](http://build.oscript.io/job/oscript-library/job/1testrunner/job/develop/)
[](https://ci.appveyor.com/project/artbear/1testrunner)
[](https://travis-ci.org/artbear/1testrunner)
Организовано приемочное тестирование, аналогичное тестированию 1C в проекте [xUnitFor1C](https://github.com/xDrivenDevelopment/xUnitFor1C/wiki)
Основные принципы работы с тестами для скриптов OneScript описаны в [официальной документации OneScript](http://oscript.io/docs/page/testing)
# Использование тестирования (выдержка из документации OneScript)
## Пример запуска всех приемочных тестов
Проверить все файлы текущего каталога из командной строки (с паузой, если есть упавшие тесты):
cmd /c C:\Projects\1script\tests\start-all.cmd .
Проверить все файлы текущего каталога из командной строки (без паузы, если есть упавшие тесты):
1testrunner -runall "ТекущийКаталог" xddReportPath "ТекущийКаталог"
или
cmd /c C:\Projects\1script\tests\start-all.cmd . notpause
## Запуск тестов
### Формат командной строки
1testrunner [-command] testfile|testdir [test-id|test-number] [-option [optionData]]
или
oscript <каталог 1testrunner>/src/main.os [-command] testfile|testdir [test-id|test-number] [-option [optionData]]
### Виды команд
* `-show` - вывод доступных тестов с именами тестов и номерами тестов по порядку объявления
* `-run` - прогон всех тестов из файла теста или одного конкретного теста, уточненного по номеру или наименованию
* `-runall` - прогон всех тестов из каталога, в т.ч. и из вложенных каталогов
### Виды режимов
* `xddReportPath` - формировать отчет тестирования в формате junit-xml
* * [optionData] - полный или относительный путь к каталогу, где формировать файл *.xml
### Примеры
* `1testrunner -show testfile` - вывод списка тестов
* `1testrunner testfile` или `1testrunner -run testfile` - запуск всех тестов из файла
* `1testrunner -run testfile 5` или `1testrunner testfile 5` - запуск теста №5
* `1testrunner -run testfile "Тест1"` или `1testrunner testfile "Тест1"`- запуск теста с именем Тест1
* `1testrunner -runall tests` - запуск всех тестов из каталога tests
* `1testrunner -runall tests xddReportPath .` - запуск всех тестов из каталога tests и формирование отчета тестирования в формате junit-xml
### Формат скриптов-тестов (предопределенные методы)
Тесты находятся в каталоге `tests`
Пример скрипта-теста находится в `tests\example-test.os` :
```bsl
#Использовать asserts
Перем юТест;
// основной метод для тестирования
Функция ПолучитьСписокТестов(ЮнитТестирование) Экспорт
юТест = ЮнитТестирование;
ВсеТесты = Новый Массив;
ВсеТесты.Добавить("ТестДолжен_ПроверитьВерсию");
Возврат ВсеТесты;
КонецФункции
// вызывается 1 раз перед выполнением всех тестов в файле
// для инициализации окружения, общего для всех тестов
//
Процедура ПередЗапускомТестов() Экспорт
КонецПроцедуры
// вызывается перед выполнением каждого тестового метода
// для выполнения общих действий перед каждым тестом
//
Процедура ПередЗапускомТеста() Экспорт
КонецПроцедуры
// вызывается после выполнения каждого тестового метода
// для выполнения общих действий после каждого теста
//
Процедура ПослеЗапускаТеста() Экспорт
КонецПроцедуры
// вызывается 1 раз после выполнения всех тестов в файле
// для выполнения общих действий после всех тестов, например, освобождения ресурсов
//
Процедура ПослеЗапускаТестов() Экспорт
КонецПроцедуры
Процедура ТестДолжен_ПроверитьВерсию() Экспорт
Утверждения.ПроверитьРавенство("0.1", Версия());
КонецПроцедуры
Функция Версия() Экспорт
Возврат "0.1";
КонецФункции
```
### Формат скриптов-тестов (аннотированные методы)
Для удобства написания тестов возможно использование анотаций методов в файле тестов:
* &Инициализация
* &Завершение
* &Перед
* &После
* &Тест
* &Параметры
См. пример.
```bsl
#Использовать asserts
Перем юТест;
// вызывается 1 раз перед выполнением всех тестов в файле
// для инициализации окружения, общего для всех тестов
// возможно последовательное выполнение нескольких методов с аннотацией &Инициализация
//
&Инициализация
Процедура ПередЗапускомТестов() Экспорт
юТест = ЮнитТестирование;
КонецПроцедуры
// вызывается перед выполнением каждого тестового метода
// для выполнения общих действий перед каждым тестом
// возможно последовательное выполнение нескольких методов с аннотацией &Перед
//
&Перед
Процедура ПередЗапускомТеста() Экспорт
КонецПроцедуры
// вызывается после выполнения каждого тестового метода
// для выполнения общих действий после каждого теста
// возможно последовательное выполнение нескольких методов с аннотацией &После
//
&После
Процедура ПослеЗапускаТеста() Экспорт
КонецПроцедуры
// вызывается 1 раз после выполнения всех тестов в файле
// для выполнения общих действий после всех тестов, например, освобождения ресурсов
// возможно последовательное выполнение нескольких методов с аннотацией &Завершение
//
&Завершение
Процедура ПослеЗапускаТестов() Экспорт
КонецПроцедуры
&Тест
Процедура ТестДолжен_ПроверитьВерсию() Экспорт
Утверждения.ПроверитьРавенство("0.1", Версия());
КонецПроцедуры
// возможна передача параметров теста через аннотацию &Параметры
// тест будет вызван для каждого набора параметров
//
&Тест
&Параметры(1, 2, Ложь)
&Параметры(1, 1, Истина)
Процедура ТестДолжен_ВыполнитьсяСПараметрами(ПервоеЗначение, ВтороеЗначение, Ожидание) Экспорт
Результат = (ПервоеЗначение = ВтороеЗначение);
Утверждения.ПроверитьРавенство(Ожидание, Результат);
КонецПроцедуры
Функция Версия() Экспорт
Возврат "0.1";
КонецФункции
```
### Механизм работы с временными файлами
В `1testrunner` встроен механизм работы с временными файлами.
Удобен для автосоздания и автоудаления файлов после выполнения тестов.
Вызывать через `юТест`.
Методы:
* **ИмяВременногоФайла**() - возвращается имя временного файла и имя фиксируется для дальнейшего удаления
* **УдалитьВременныеФайлы**() - удаляются все зарегистрированные ранее временные файлы
* * Удобно этот метод использовать в 'ПослеЗапускаТеста'
Пример использования методов находятся в тесте temp-files.os
## Запуск тестирования из Notepad++
### Для прогона тестов из текущего открытого файла скрипта
в Notepad++ (в т.ч. и для плагина NppExec) можно использовать следующую команду:
cmd.exe /c C:\Projects\1script\tests\start.cmd "$(FULL_CURRENT_PATH)"
или
1testrunner -run "$(FULL_CURRENT_PATH)"
В случае ошибок в тестах/файле будет выдано окно консоли с описанием ошибки.
### Для запуска всех приемочных тестов в текущем каталоге
1testrunner -runall "$(CURRENT_DIRECTORY)"