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
32 changes: 32 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ OneUnit поддерживает следующие аннотации для н
| `&Изолированный` | Выполняет тест или весь набор [в изоляции](#113-изоляция-тестов) - в свежей поделке или в отдельном процессе |
| `&ИнформацияОТесте` | Передает [сведения о текущем тесте или наборе](#1141-информация-о-тесте) в параметр или поле |
| `&ИнформацияОПовторении` | Передает [номер и количество повторений](#1142-информация-о-повторении) в параметр или поле |
| `&ИнформацияОПараметризованномВызове` | Передает [номер вызова и аргументы источника](#1143-информация-о-параметризованном-вызове) в параметр или поле |

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

Expand Down Expand Up @@ -709,6 +710,37 @@ OneUnit предоставляет возможность повторять т
разрешения; умолчание параметра не используется. Аннотация поля подходит для наборов,
в которых все тесты повторяемые и нет методов уровня набора.

#### 1.14.3 Информация о параметризованном вызове

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

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

`НомерВызова()` начинается с единицы и задаётся в порядке вызовов текущего метода.
Он сохраняется при одинаковых значениях аргументов и отображаемых именах вызовов.

`Аргументы()` возвращает фиксированный список позиционных значений, подготовленных источником.
Индексы списка начинаются с нуля. В примере выше это `[11]` для первого вызова и `[22]` для второго.
Параметр `Вызов` OneUnit заполняет по его аннотации. Другие параметры, заполняемые по своим аннотациям,
например [`&ИнформацияОТесте`](#1141-информация-о-тесте), в этот список не входят.
Значения по умолчанию автоматически не подставляются. Список доступен только для чтения.

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

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

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

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

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

Возвращаемое значение имеет тип
[ИнформацияОПараметризованномВызове](../Классы/ИнформацияОПараметризованномВызове.md).
Объект содержит номер вызова с единицы и фиксированный список аргументов источника с индексами с нуля.
В примере вызовы получают списки `[11]` и `[22]`. Параметр `Вызов` OneUnit заполняет по его аннотации.
Другие параметры, заполняемые по своим аннотациям, например [`&ИнформацияОТесте`](ИнформацияОТесте.md),
в список не входят. Значения по умолчанию автоматически не подставляются.

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

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

## НомерВызова

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

Нумерация начинается заново для каждого метода и не зависит от отображаемого имени вызова.

## Аргументы

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

Индексы начинаются с нуля. Список содержит позиционные значения, подготовленные источником.
Параметры, которые OneUnit заполняет по аннотациям, например
[`&ИнформацияОТесте`](../Аннотации/ИнформацияОТесте.md), в список не включаются.
Значения по умолчанию автоматически не подставляются.
Список доступен только для чтения; переданный конструктору изменяемый список копируется.
2 changes: 2 additions & 0 deletions lib.config
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,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"/>
<class name="АннотацияОтображаемоеИмя" file="src/core/Классы/АннотацияОтображаемоеИмя.os"/>
<class name="АннотацияПараметризованныйТест" file="src/core/Классы/АннотацияПараметризованныйТест.os"/>
<class name="АннотацияПередВсеми" file="src/core/Классы/АннотацияПередВсеми.os"/>
Expand All @@ -30,6 +31,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
3 changes: 2 additions & 1 deletion packagedef
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,9 @@
.ЗависитОт("collectionos", "0.8.4")
.ЗависитОт("coverage", "0.7.0")
.ЗависитОт("decorator", "3.0.0")
.ЗависитОт("fluent", "0.6.2")
.ЗависитОт("fs", "1.2.0")
.ЗависитОт("lambdas", "0.3.4")
.ЗависитОт("lambdas", "0.3.5")
.ЗависитОт("logos", "1.7.1")
.ЗависитОт("optional", "2.2.1")
.ЗависитОт("semver", "1.1.1")
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,8 @@
Порядок,
Опциональные.Пустой(),
ИсполнителиТестов.Асинхронный,
Описание.Повторение()
Описание.Повторение(),
Описание.НомерПараметризованногоВызова()
)
)
);
Expand Down Expand Up @@ -245,6 +246,7 @@
Свойства.Порядок,
Свойства.Изоляция,
ИмяИсполнителя(Свойства.Изоляция),
Опциональные.Пустой(),
Опциональные.Пустой()
)
);
Expand Down
19 changes: 16 additions & 3 deletions src/core/internal/Классы/ОписаниеТеста.os
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
Перем _Имя;
Перем _Параметры;
Перем СведенияОПовторении; // Опциональный - ИнформацияОПовторении; пустой для других видов вызовов
Перем НомерВызова; // Опциональный - Число; номер параметризованного вызова с единицы

Функция Имя() Экспорт
Возврат _Имя;
Expand All @@ -22,25 +23,37 @@
Возврат СведенияОПовторении;
КонецФункции

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

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

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

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

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

Функция ТипОпределения() Экспорт
Возврат _Тип;
Expand Down Expand Up @@ -50,6 +51,15 @@
Возврат СведенияОПовторении;
КонецФункции

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

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

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

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

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

Перем ИнформацияВызовов; // Табакерка - Сведения о вызовах

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

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

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

Номер = Узел.НомерПараметризованногоВызова();

Если Номер.СодержитЗначение() Тогда

Возврат ИнформацияВызовов.Достать(Массивы.ИзЭлементов(
Номер.Получить(),
Узел.Параметры()
));

КонецЕсли;

КонецЕсли;

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

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

&Желудь
Процедура ПриСозданииОбъекта(
&Табакерка &Пластилин("ИнформацияОПараметризованномВызове") СведенияОВызовах)
ИнформацияВызовов = СведенияОВызовах;
КонецПроцедуры
Loading
Loading