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

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

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

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

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

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

```bsl
&Тест
&ОтображаемоеИмя("Проверка расчёта")
&Тег("Расчёты")
Процедура Проверка(&ИнформацияОТесте Информация) Экспорт
Сообщить(Информация.ОтображаемоеИмя());
Сообщить(Информация.Метод().Получить().Имя());
КонецПроцедуры
```

Объект содержит:

| Метод | Значение |
|---|---|
| `ОтображаемоеИмя()` | Имя текущего теста или набора; для повторения и параметризованного вызова - имя конкретной итерации |
| `Теги()` | Фиксированное множество тегов метода и набора без повторений |
| `Набор()` | Тип сценария тестового набора |
| `Метод()` | Опциональный с [описанием исходного тестового метода](./docs/api/Классы/ИнформацияОМетоде.md); пустой на уровне набора |

Тестовый метод, `ПередКаждым` и `ПослеКаждого` получают сведения о выполняемом тесте.

У компанейского набора каждый тест выполняется на отдельном экземпляре набора.
Конструктор этого экземпляра получает сведения о тесте, который будет на нём выполнен.

В `ПередВсеми`, `ПослеВсех` и конструкторе одиночки передаются сведения о наборе целиком.

В повторении и параметризованном вызове `Метод()` описывает исходный метод шаблона.
Описание метода предоставляет `Имя()` и `Набор()`, возвращающий тип сценария с этим методом.

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

Поля заполняются после проверки условий и перед выполнением методов текущего узла.
В конструкторе сведения передаются через параметр. При вычислении выражения источника или совета
уровня `Поделка` параметр конструктора с этой аннотацией получает `Неопределено`.
Для совета уровня `Процесс` действуют [правила создания экземпляра без аргументов](#113-изоляция-тестов):
обязательные параметры исключают создание, а необязательные получают значения по умолчанию.

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

### 2.1 Запуск тестов из командной строки
Expand Down
27 changes: 27 additions & 0 deletions docs/api/Аннотации/ИнформацияОТесте.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# АннотацияИнформацияОТесте

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

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

Возвращаемое поставщиком значение имеет тип [ИнформацияОТесте](../Классы/ИнформацияОТесте.md).
26 changes: 26 additions & 0 deletions docs/api/Классы/ИнформацияОМетоде.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# ИнформацияОМетоде

Неизменяемое описание исходного тестового метода. Возвращается методом
[`ИнформацияОТесте.Метод()`](ИнформацияОТесте.md#метод).

## Имя

```bsl
// Возвращает имя метода в сценарии тестового набора.
//
// Возвращаемое значение:
// Строка - Имя метода
//
Функция Имя() Экспорт
```

## Набор

```bsl
// Возвращает тип сценария, в котором объявлен метод.
//
// Возвращаемое значение:
// Тип - Тип сценария тестового набора
//
Функция Набор() Экспорт
```
54 changes: 54 additions & 0 deletions docs/api/Классы/ИнформацияОТесте.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# ИнформацияОТесте

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

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

## ОтображаемоеИмя

```bsl
// Возвращает отображаемое имя текущего теста или набора.
// Для повторения и параметризованного вызова возвращает имя конкретной итерации.
//
// Возвращаемое значение:
// Строка - Отображаемое имя
//
Функция ОтображаемоеИмя() Экспорт
```

## Теги

```bsl
// Возвращает теги текущего узла, включая теги тестового набора.
//
// Возвращаемое значение:
// ФиксированноеМножество из Строка - Теги без повторений
//
Функция Теги() Экспорт
```

## Набор

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

## Метод

```bsl
// Возвращает описание исходного тестового метода.
// Для повторения и параметризованного вызова возвращает метод шаблона.
//
// Возвращаемое значение:
// Опциональный - ИнформацияОМетоде; пустой - текущий узел является набором
//
Функция Метод() Экспорт
```

Описание метода имеет тип [ИнформацияОМетоде](ИнформацияОМетоде.md).
3 changes: 3 additions & 0 deletions lib.config
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@
<class name="АннотацияИсточникПеречисление" file="src/core/Классы/АннотацияИсточникПеречисление.os"/>
<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"/>
Expand All @@ -25,6 +26,8 @@
<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"/>

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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,15 @@
Возврат _Определение.Имя();
КонецФункции

// Тип сценария тестового набора.
//
// Возвращаемое значение:
// Тип - Тип, экземпляры которого создаются для набора
//
Функция ТипСценария() Экспорт
Возврат _Определение.ТипЖелудя();
КонецФункции

Функция Таймаут() Экспорт
Возврат ?(ЗначениеЗаполнено(_Таймаут), _Таймаут, Родитель().Таймаут());
КонецФункции
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
// Сведения о текущем узле исполнения для аннотации ИнформацияОТесте.

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

Перем ФабрикаИнформации; // Табакерка - Сведения о тестах и наборах

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

Узел = Контекст.Узел();
Метод = Опциональные.Пустой();

Если ТипЗнч(Узел) = Тип("ОпределениеТеста") Тогда
Метод = Новый Опциональный(Узел.ИмяМетода());
КонецЕсли;

Возврат ФабрикаИнформации.Достать(Массивы.ИзЭлементов(
Узел.Имя(),
Узел.Теги(),
Узел.Набор().ТипСценария(),
Метод
));

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

&Желудь
Процедура ПриСозданииОбъекта(&Табакерка &Пластилин("ИнформацияОТесте") ТабакеркаИнформации)
ФабрикаИнформации = ТабакеркаИнформации;
КонецПроцедуры
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
// Передает сведения о текущем тесте или наборе в параметр конструктора,
// тестового метода, метода жизненного цикла или в поле набора.
// Поля получают значение после проверки условий и перед методами текущего узла.
//
// Тестовый метод, ПередКаждым и ПослеКаждого получают сведения о выполняемом тесте.
// У компанейского набора каждый тест выполняется на отдельном экземпляре набора.
// Конструктор этого экземпляра получает сведения о тесте, который будет на нём выполнен.
// ПередВсеми, ПослеВсех и конструктор одиночки получают сведения о наборе целиком.
// При вычислении выражения источника или совета уровня Поделка параметр конструктора
// получает Неопределено. Для совета уровня Процесс экземпляр создается без аргументов:
// обязательные параметры исключают создание, а необязательные получают значения по умолчанию.
//
// Пример:
// &Тест
// Процедура Проверка(&ИнформацияОТесте Информация) Экспорт
// Сообщить(Информация.ОтображаемоеИмя());
// КонецПроцедуры
//
&Аннотация("ИнформацияОТесте")
&ПоставщикЗначения("ПоставщикИнформацииОТесте")
Процедура ПриСозданииОбъекта()
КонецПроцедуры
31 changes: 31 additions & 0 deletions src/core/Классы/ИнформацияОМетоде.os
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
// Описание исходного тестового метода.

Перем Имя; // Строка - Имя метода в сценарии
Перем Набор; // Тип - Тип сценария, в котором объявлен метод

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

// Возвращает тип сценария, в котором объявлен метод.
//
// Возвращаемое значение:
// Тип - Тип сценария тестового набора
//
Функция Набор() Экспорт
Возврат Набор;
КонецФункции

&Желудь
&Характер("Компанейский")
Процедура ПриСозданииОбъекта(&Блестяшка ИмяМетода, &Блестяшка ТипНабора)

Имя = ИмяМетода;
Набор = ТипНабора;

КонецПроцедуры
Loading
Loading