Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 28 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,8 @@ OneUnit поддерживает следующие аннотации для н
| `&Выключен` | Используется для [отключения](#15-отключение-тестов) тестового набора или тестового метода |
| `&Таймаут` | Используется для провала `&Тест`, `&ПараметризованныйТест` или `&ПовторяемыйТест` метода, если его выполнение превышает заданную продолжительность. |
| `&Изолированный` | Выполняет тест или весь набор [в изоляции](#113-изоляция-тестов) - в свежей поделке или в отдельном процессе |
| `&ИнформацияОТесте` | Передает [сведения о текущем тесте или наборе](#114-информация-о-текущем-тесте) в параметр или поле |
| `&ИнформацияОТесте` | Передает [сведения о текущем тесте или наборе](#1141-информация-о-тесте) в параметр или поле |
| `&ИнформацияОПовторении` | Передает [номер и количество повторений](#1142-информация-о-повторении) в параметр или поле |

### 1.2 Тестовые методы и наборы

Expand Down Expand Up @@ -639,7 +640,9 @@ OneUnit предоставляет возможность повторять т

Обнаружение тестов (`oneunit discover` и MCP-инструмент `discover_tests`) показывает фактический состав изолированных наборов: состав обнаруживается в изолированной среде без исполнения тестов, поэтому внешний тулинг видит их так же, как обычные наборы. Если состав обнаружить не удалось (например, дочерний процесс упал, не составив план), набор выводится сломанным с краткой причиной, вывод дочернего процесса - в подробных причинах после плана, а обнаружение завершается с ненулевым кодом возврата.

### 1.14 Информация о текущем тесте
### 1.14 Метаинформация о тестах

#### 1.14.1 Информация о тесте

Аннотация [`&ИнформацияОТесте`](./docs/api/Аннотации/ИнформацияОТесте.md) передает объект
[`ИнформацияОТесте`](./docs/api/Классы/ИнформацияОТесте.md) в параметр конструктора, тестового метода,
Expand Down Expand Up @@ -683,6 +686,29 @@ OneUnit предоставляет возможность повторять т
Для совета уровня `Процесс` действуют [правила создания экземпляра без аргументов](#113-изоляция-тестов):
обязательные параметры исключают создание, а необязательные получают значения по умолчанию.

#### 1.14.2 Информация о повторении

Аннотация [`&ИнформацияОПовторении`](./docs/api/Аннотации/ИнформацияОПовторении.md) передает объект
[`ИнформацияОПовторении`](./docs/api/Классы/ИнформацияОПовторении.md) в параметр повторяемого теста,
`ПередКаждым`, `ПослеКаждого` или в поле набора.

```bsl
&ПовторяемыйТест(3)
Процедура Проверка(&ИнформацияОПовторении Повторение) Экспорт
Сообщить(Повторение.ТекущееПовторение()); // 1, 2, 3
Сообщить(Повторение.ВсегоПовторений()); // 3
КонецПроцедуры
```

Номер начинается с единицы и не зависит от отображаемого имени вызова. Поле заполняется перед
методами текущего повторения. У одиночки оно обновляется перед каждым повторением;
сохранённые ссылки продолжают описывать прежнее повторение.

В обычном тесте, параметризованном вызове, конструкторе, `ПередВсеми` и `ПослеВсех`
сведения о повторении недоступны. Запрос значения в этих случаях завершает узел ошибкой
разрешения; умолчание параметра не используется. Аннотация поля подходит для наборов,
в которых все тесты повторяемые и нет методов уровня набора.

## 2. Запуск тестов

### 2.1 Запуск тестов из командной строки
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# АннотацияИнформацияОПовторении

## ПриСозданииОбъекта

```bsl
// Передает информацию о текущем повторении в параметр повторяемого теста,
// ПередКаждым, ПослеКаждого или в поле набора перед выполнением повторения.
// В обычном тесте, параметризованном вызове, конструкторе, ПередВсеми и ПослеВсех
// значение недоступно: запрос вызывает ошибку разрешения значения.
// Умолчание параметра не используется при ошибке поставщика.
//
// Пример:
// &ПовторяемыйТест(3)
// Процедура Проверка(&ИнформацияОПовторении Повторение) Экспорт
// Сообщить(Повторение.ТекущееПовторение());
// Сообщить(Повторение.ВсегоПовторений());
// КонецПроцедуры
//
Процедура ПриСозданииОбъекта()
```

Возвращаемое поставщиком значение имеет тип [ИнформацияОПовторении](../Классы/ИнформацияОПовторении.md).
Номер начинается с единицы и не зависит от отображаемого имени вызова.

Поля получают значение после проверки условий и перед методами текущего повторения.
У одиночки поле обновляется перед очередным повторением; ранее полученные объекты сохраняют свои сведения.
Аннотация поля подходит для наборов, в которых все тесты повторяемые и нет методов уровня набора.
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# ИнформацияОПовторении

Сведения о текущем повторении, получаемые через [`&ИнформацияОПовторении`](../Аннотации/ИнформацияОПовторении.md).
Полученный объект сохраняет номер и количество на момент получения.

## ТекущееПовторение

```bsl
// Возвращает номер текущего повторения.
//
// Возвращаемое значение:
// Число - Номер повторения, начиная с единицы
//
Функция ТекущееПовторение() Экспорт
```

## ВсегоПовторений

```bsl
// Возвращает общее количество повторений теста.
//
// Возвращаемое значение:
// Число - Количество повторений
//
Функция ВсегоПовторений() Экспорт
```
2 changes: 2 additions & 0 deletions lib.config
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
<class name="АннотацияИсточникJSON" file="src/core/Классы/АннотацияИсточникJSON.os"/>
<class name="АннотацияИзолированный" file="src/core/Классы/АннотацияИзолированный.os"/>
<class name="АннотацияИнформацияОТесте" file="src/core/Классы/АннотацияИнформацияОТесте.os"/>
<class name="АннотацияИнформацияОПовторении" file="src/core/Классы/АннотацияИнформацияОПовторении.os"/>
<class name="АннотацияОтображаемоеИмя" file="src/core/Классы/АннотацияОтображаемоеИмя.os"/>
<class name="АннотацияПараметризованныйТест" file="src/core/Классы/АннотацияПараметризованныйТест.os"/>
<class name="АннотацияПередВсеми" file="src/core/Классы/АннотацияПередВсеми.os"/>
Expand All @@ -28,6 +29,7 @@
<class name="МенеджерТестирования" file="src/core/Классы/МенеджерТестирования.os"/>
<class name="ИнформацияОТесте" file="src/core/Классы/ИнформацияОТесте.os"/>
<class name="ИнформацияОМетоде" file="src/core/Классы/ИнформацияОМетоде.os"/>
<class name="ИнформацияОПовторении" file="src/core/Классы/ИнформацияОПовторении.os"/>

<module name="Предполагаем" file="src/core/Модули/Предполагаем.os"/>

Expand Down
1 change: 1 addition & 0 deletions packagedef
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@
.ЗависитОт("fs", "1.2.0")
.ЗависитОт("lambdas", "0.3.4")
.ЗависитОт("logos", "1.7.1")
.ЗависитОт("optional", "2.2.1")
.ЗависитОт("semver", "1.1.1")
.ЗависитОт("tempfiles", "1.1.1")

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,7 @@

// Изолированный тест получает значения в своей среде: доступность
// поставщиков проверит она

Если Не ОшибкаОбнаружения.СодержитЗначение() И Не Объявление.Изоляция.СодержитЗначение() Тогда
ОшибкаОбнаружения = ОшибкаРегистрацииТеста(Сигнатуры, ТестМетод.Имя, ТестНабор);
КонецЕсли;
Expand Down Expand Up @@ -145,21 +146,25 @@
Описания = Новый СписокМассив;

Если Не ОшибкаОбнаружения.СодержитЗначение() Тогда

Итерации = ИтерацииШаблона(ТестМетод, ОтображаемоеИмя, ТестНабор);
ОшибкаОбнаружения = Итерации.Ошибка;
Описания = Итерации.Описания;

КонецЕсли;

Если ОшибкаОбнаружения.СодержитЗначение() Тогда
// Шаблон без итераций становится тестом со своей ошибкой обнаружения:
// так его видят статистика и все отчеты

Определение = ОпределениеМетода(
ТипыОпределенийТестов.Тест,
Новый СписокМассив,
ТестМетод,
ТестНабор,
Свойства
);

Иначе
Определение.ДобавитьВыводОбнаружения(Итерации.Вывод);
КонецЕсли;
Expand All @@ -181,7 +186,8 @@
Свойства.Условия,
Порядок,
Опциональные.Пустой(),
ИсполнителиТестов.Асинхронный
ИсполнителиТестов.Асинхронный,
Описание.Повторение()
)
)
);
Expand Down Expand Up @@ -238,7 +244,8 @@
Свойства.Условия,
Свойства.Порядок,
Свойства.Изоляция,
ИмяИсполнителя(Свойства.Изоляция)
ИмяИсполнителя(Свойства.Изоляция),
Опциональные.Пустой()
)
);

Expand Down
23 changes: 22 additions & 1 deletion src/core/internal/Классы/ОписаниеТеста.os
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@

Перем _Имя;
Перем _Параметры;
Перем СведенияОПовторении; // Опциональный - ИнформацияОПовторении; пустой для других видов вызовов

Функция Имя() Экспорт
Возврат _Имя;
Expand All @@ -12,14 +13,34 @@
Возврат _Параметры;
КонецФункции

// Возвращает сведения о повторении, если описание относится к повторяемому тесту.
//
// Возвращаемое значение:
// Опциональный - ИнформацияОПовторении; пустой - это другой вид вызова
//
Функция Повторение() Экспорт
Возврат СведенияОПовторении;
КонецФункции

// Создает неизменяемое описание вызова теста.
//
// Параметры:
// Имя - Строка - Отображаемое имя вызова
// Параметры - Список из Произвольный - Позиционные значения параметров
// Повторение - Опциональный - ИнформацияОПовторении; пустой для других видов вызовов
//
&Желудь
&Характер("Компанейский")
Процедура ПриСозданииОбъекта(&Блестяшка Знач Имя, &Блестяшка Знач Параметры) Экспорт
Процедура ПриСозданииОбъекта(
&Блестяшка Знач Имя,
&Блестяшка Знач Параметры,
&Блестяшка Повторение) Экспорт

Ожидаем.Что(Имя).ИмеетТип("Строка").Заполнено();
Параметры = Списки.Скопировать(Параметры);

_Имя = Имя;
_Параметры = Параметры;
СведенияОПовторении = Повторение;

КонецПроцедуры
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
Перем _ОшибкиОбнаружения;
Перем _ВыводОбнаружения; // Строка - Вывод, перехваченный при обнаружении итераций шаблона
Перем Контекст; // КонтекстИсполнения - Контекст исполнения теста
Перем СведенияОПовторении; // Опциональный - ИнформацияОПовторении; пустой для других видов узлов

Функция ТипОпределения() Экспорт
Возврат _Тип;
Expand All @@ -40,6 +41,15 @@
Возврат _Параметры;
КонецФункции

// Возвращает сведения о повторении для конкретного повторяемого вызова.
//
// Возвращаемое значение:
// Опциональный - ИнформацияОПовторении; пустой - узел не является повторением
//
Функция Повторение() Экспорт
Возврат СведенияОПовторении;
КонецФункции

Функция Имя() Экспорт
Возврат _Имя;
КонецФункции
Expand Down Expand Up @@ -172,7 +182,8 @@
&Блестяшка Условия,
&Блестяшка Порядок,
&Блестяшка Изоляция,
&Блестяшка Исполнитель)
&Блестяшка Исполнитель,
&Блестяшка Повторение)

_Тип = Тип;
_Имя = Имя;
Expand All @@ -189,5 +200,6 @@
_ОшибкиОбнаружения = Новый СписокМассив;
_ВыводОбнаружения = "";
Контекст = Новый КонтекстИсполнения(ЭтотОбъект);
СведенияОПовторении = Повторение;

КонецПроцедуры
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
// Информация о повторении из описания текущего вызова.

#Использовать collectionos

// Параметры:
// КонтекстЭлемента - КонтекстПараметра, КонтекстПоля - Параметр или поле, которому нужно значение
// Контекст - КонтекстИсполнения - Контекст текущего узла
//
// Возвращаемое значение:
// ИнформацияОПовторении - Номер текущего повторения и общее количество
//
Функция Значение(КонтекстЭлемента, Контекст) Экспорт // BSLLS:UnusedParameters-off

Узел = Контекст.Узел();

Если ТипЗнч(Узел) = Тип("ОпределениеТеста") Тогда

Повторение = Узел.Повторение();

Если Повторение.СодержитЗначение() Тогда
Возврат Повторение.Получить();
КонецЕсли;

КонецЕсли;

ВызватьИсключение "Информация о повторении доступна только при выполнении повторяемого теста";

КонецФункции

&Желудь
Процедура ПриСозданииОбъекта()
КонецПроцедуры
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,10 @@
.Обработать("Параметры -> {
| Имя = СтрЗаменить(ШаблонИмени, ""{Параметры}"", Параметры);
|
| Возврат Поделка.НайтиЖелудь(""ОписаниеТеста"", Массивы.ИзЭлементов(Имя, Параметры));
| Возврат Поделка.НайтиЖелудь(
| ""ОписаниеТеста"",
| Массивы.ИзЭлементов(Имя, Параметры, Опциональные.Пустой())
| );
|}",
Новый Структура("ШаблонИмени, Поделка", ШаблонИмени, _Поделка)
);
Expand Down
Loading
Loading