feat: Добавление указание наименования бенчмарка

- Добавлен параметр Наименование в аннотацию &Бенчмарк
- Добавлен API дескриптора Наименование()/УстановитьНаименование()

Author: Stivo182

samples/benchmarks/examples/БенчмаркСортировок.os

@@ -94,7 +94,7 @@
 // Встроенная сортировка (эталон).
 // Сортирует через ТаблицаЗначений.Сортировать(), затем копирует обратно в массив.
 // Служит базой для Ratio - все остальные алгоритмы сравниваются с этим.
-&Бенчмарк
+&Бенчмарк(Наименование = "Встроенная")
 &Эталон
 &Параметры(1000)
 &Параметры(10000)
@@ -112,7 +112,7 @@
 // Сортировка пузырьком - O(n²).
 // Простейший алгоритм: соседние элементы сравниваются и меняются местами.
 // Всегда выполняет n*(n-1)/2 сравнений независимо от входных данных.
-&Бенчмарк
+&Бенчмарк(Наименование = "Пузырьком O(n²)")
 &Параметры(1000)
 Процедура СортировкаПузырьком(РазмерМассива) Экспорт
 
@@ -133,7 +133,7 @@
 // Сортировка вставками - O(n²), лучший O(n).
 // Каждый элемент сдвигается влево до своей позиции.
 // Эффективна на малых и почти отсортированных массивах; используется как базис в гибридных алгоритмах.
-&Бенчмарк
+&Бенчмарк(Наименование = "Вставками O(n²)")
 &Параметры(1000)
 Процедура СортировкаВставками(РазмерМассива) Экспорт
 
@@ -155,7 +155,7 @@
 
 // Бинарная сортировка вставками - O(n²) сдвигов, O(n log n) сравнений.
 // Позиция вставки ищется бинарным поиском, но сдвиг элементов остаётся линейным.
-&Бенчмарк
+&Бенчмарк(Наименование = "Бинарные вставки O(n²)")
 &Параметры(1000)
 Процедура СортировкаВставкамиБинарная(РазмерМассива) Экспорт
 
@@ -193,7 +193,7 @@
 // Двойная сортировка выбором - O(n²).
 // На каждом проходе находит минимум и максимум, сужая границы с двух сторон.
 // Вдвое меньше проходов, чем классическая сортировка выбором.
-&Бенчмарк
+&Бенчмарк(Наименование = "Выбором (двойная) O(n²)")
 &Параметры(1000)
 Процедура СортировкаВыбором(РазмерМассива) Экспорт
 
@@ -244,7 +244,7 @@
 // Обобщение сортировки вставками с убывающим шагом.
 // Последовательность Ciura [1,4,10,23,57,132,301,701] эмпирически оптимальна;
 // для массивов >701 элемента шаги продолжаются с множителем ×2.25.
-&Бенчмарк
+&Бенчмарк(Наименование = "Шелла (Ciura) O(n^1.25)")
 &Параметры(1000)
 &Параметры(10000)
 Процедура СортировкаШелла(РазмерМассива) Экспорт
@@ -302,7 +302,7 @@
 // Гибрид быстрой + пирамидальной + вставками.
 // Медиана трёх для выбора опорного, лимит глубины 2·log2(n) с переходом на пирамидальную,
 // участки < МинимальныйРазмерВставки досортировываются вставками.
-&Бенчмарк
+&Бенчмарк(Наименование = "Быстрая O(n log n)")
 &Параметры(1000)
 &Параметры(10000)
 Процедура БыстраяСортировка(РазмерМассива) Экспорт
@@ -406,7 +406,7 @@
 // Блоки размером МинимальныйРазмерВставки сортируются вставками,
 // затем попарно сливаются с удвоением ширины. Единый буфер на все слияния.
 // Оптимизация: пропуск слияния, если граница уже упорядочена.
-&Бенчмарк
+&Бенчмарк(Наименование = "Слиянием O(n log n)")
 &Параметры(1000)
 &Параметры(10000)
 Процедура СортировкаСлиянием(РазмерМассива) Экспорт
@@ -494,7 +494,7 @@
 // Пирамидальная сортировка - O(n log n).
 // Построение max-heap за O(n), затем n извлечений вершины.
 // Просеивание (sift-down) заинлайнено для производительности в интерпретаторе.
-&Бенчмарк
+&Бенчмарк(Наименование = "Пирамидальная O(n log n)")
 &Параметры(1000)
 &Параметры(10000)
 Процедура ПирамидальнаяСортировка(РазмерМассива) Экспорт
@@ -645,7 +645,7 @@
 // Сортировка расчёской - O(n log n) в среднем.
 // Улучшение пузырька: шаг сравнения уменьшается с коэффициентом 1.3 до 1.
 // Эффективно устраняет «черепах» - мелкие элементы в конце массива.
-&Бенчмарк
+&Бенчмарк(Наименование = "Расчёской O(n log n)")
 &Параметры(1000)
 &Параметры(10000)
 Процедура СортировкаРасческой(РазмерМассива) Экспорт
@@ -679,7 +679,7 @@
 // Сортировка подсчётом - O(n + k), где k = ВерхняяГраница.
 // Не основана на сравнениях: считает количество вхождений каждого значения.
 // Эффективна при k ≈ n; при k >> n большая часть работы - пустой пробег по счётчикам.
-&Бенчмарк
+&Бенчмарк(Наименование = "Подсчётом O(n + k)")
 &Параметры(1000)
 &Параметры(10000)
 &Параметры(100000)
@@ -711,7 +711,7 @@
 // Поразрядная сортировка (LSD Radix-256) - O(d·(n+b)), где d=2, b=256.
 // Два прохода по основанию 256: сначала младшие 8 бит, затем старшие.
 // Покрывает значения [0..65535]. Стабильная, не основана на сравнениях.
-&Бенчмарк
+&Бенчмарк(Наименование = "Поразрядная Radix-256 (LSD) O(d*(n+b))")
 &Параметры(1000)
 &Параметры(10000)
 &Параметры(100000)
@@ -807,4 +807,4 @@
 
     Возврат 0;
 
-КонецФункции
+КонецФункции

src/BenchmarkOneScript/core/Классы/АннотацияБенчмарк.os

@@ -1,14 +1,23 @@
 // Указывает, что метод должен быть измерен как бенчмарк в рамках тестирования производительности.
 //
-// Методы с этой аннотацией автоматически включаются в процесс бенчмаркинга. 
-// При запуске будут замеряться время выполнения, аллокации памяти (если включен мониторинг памяти), 
+// Методы с этой аннотацией автоматически включаются в процесс бенчмаркинга.
+// При запуске будут замеряться время выполнения, аллокации памяти (если включен мониторинг памяти),
 // и другие параметры производительности.
 //
+// Параметры:
+//   Наименование - Строка - Наименование бенчмарка. Если указано, отображается в колонке Method отчета
+//                           вместо имени метода.
+//
 // Примеры:
 //   &Бенчмарк
 //   Процедура МойБенчмарк() Экспорт
 //      // Тестируемый код
 //   КонецПроцедуры
+//
+//   &Бенчмарк(Наименование = "Мое наименование")
+//   Процедура МойБенчмарк() Экспорт
+//      // Тестируемый код
+//   КонецПроцедуры
 &Аннотация("Бенчмарк")
-Процедура ПриСозданииОбъекта()
-КонецПроцедуры
+Процедура ПриСозданииОбъекта(Наименование = "")
+КонецПроцедуры

src/BenchmarkOneScript/core/Классы/ДескрипторБенчмарка.os

@@ -25,6 +25,10 @@
 &Тип("Массив") &ДляКаждого &Тип("ПараметрыМетодаБенчмарка")
 Перем _НаборыПараметров; // Массив из ПараметрыМетодаБенчмарка
 
+&Сериализуемое("Title")
+&Тип("Строка")
+Перем _Наименование; // Строка - Наименование бенчмарка
+
 &Сериализуемое("ParameterSources")
 &Тип("Массив")
 Перем _ИсточникиПараметров; // Массив из Строка
@@ -46,6 +50,7 @@
 	_НаборыПараметров = Новый Массив();
 	_ЭтоЭталон = Ложь;
 	_Категория = "";
+	_Наименование = "";
 	_ИсточникиПараметров = Новый Массив();
 
 	Если Не Объект = Неопределено Тогда
@@ -90,6 +95,14 @@
 	Возврат _Категория;
 КонецФункции
 
+// Наименование бенчмарка
+//
+// Возвращаемое значение:
+//   Строка
+Функция Наименование() Экспорт
+	Возврат _Наименование;
+КонецФункции
+
 // Наборы параметров, используемые для запуска бенчмарков с различными входными данными.
 //
 // Возвращаемое значение:
@@ -149,6 +162,23 @@
 
 КонецФункции
 
+// Устанавливает наименование бенчмарка.
+//
+// Если наименование указано, оно отображается в колонке Method отчёта вместо имени метода.
+//
+// Параметры:
+//   Наименование - Строка
+//
+// Возвращаемое значение:
+//   ЭтотОбъект
+Функция УстановитьНаименование(Наименование) Экспорт
+
+	_Наименование = Наименование;
+
+	Возврат ЭтотОбъект;
+
+КонецФункции
+
 // Добавляет параметры бенчмарка, позволяя запускать тесты с различными наборами входных данных.
 //
 // Принимает значения только примитивного типа. 
@@ -268,6 +298,7 @@
 
 	Дескриптор.ИспользоватьКакЭталон(ЭтоЭталон());
 	Дескриптор.УстановитьКатегорию(Категория());
+	Дескриптор.УстановитьНаименование(Наименование());
 
 	Возврат Дескриптор;
 
@@ -380,4 +411,4 @@
 	КонецЕсли;
 КонецПроцедуры
 
-#КонецОбласти
+#КонецОбласти

src/BenchmarkOneScript/core/Классы/ИзвлекательДескрипторовБенчмарков.os

@@ -63,6 +63,7 @@
 
 	ДескрипторБенчмарка = Новый ДескрипторБенчмарка(_ИсточникБенчмарков, СвойстваМетода.Имя);
 
+	ПрочитатьНаименованиеИзАннотацииБенчмарк(СвойстваМетода, ДескрипторБенчмарка);
 	ПрочитатьАннотациюЭталон(СвойстваМетода, ДескрипторБенчмарка);
 	ПрочитатьАннотациюКатегория(СвойстваМетода, ДескрипторБенчмарка);
 	ПрочитатьАннотациюПараметры(СвойстваМетода, ДескрипторБенчмарка);
@@ -72,6 +73,25 @@
 
 КонецФункции
 
+// Читает параметр Наименование из аннотации &Бенчмарк и устанавливает его в дескриптор
+//
+// Параметры:
+//   СвойстваМетода      - СтрокаТаблицыЗначений - Свойства метода, полученные через рефлектор
+//   ДескрипторБенчмарка - ДескрипторБенчмарка   - Дескриптор для заполнения
+Процедура ПрочитатьНаименованиеИзАннотацииБенчмарк(СвойстваМетода, ДескрипторБенчмарка)
+
+	Аннотация = РаботаСАннотациями.ПолучитьАннотацию(СвойстваМетода, "Бенчмарк");
+	Если Аннотация = Неопределено Тогда
+		Возврат;
+	КонецЕсли;
+
+	Наименование = РаботаСАннотациями.ПолучитьЗначениеПараметраАннотации(Аннотация, "Наименование", "");
+	Если ЗначениеЗаполнено(Наименование) Тогда
+		ДескрипторБенчмарка.УстановитьНаименование(Наименование);
+	КонецЕсли;
+
+КонецПроцедуры
+
 // Читает аннотацию &Эталон и помечает бенчмарк как эталонный, если она присутствует
 //
 // Параметры:

src/BenchmarkOneScript/core/Модули/КолонкаОтчетаБенчмарковМетод.os

@@ -22,6 +22,13 @@
 //   Произвольный
 Функция Значение(РезультатЗапускаКейса, Колонка) Экспорт // BSLLS:UnusedParameters-off
 
-	Возврат РезультатЗапускаКейса.Кейс.ДескрипторБенчмарка().Метод();
+	Дескриптор = РезультатЗапускаКейса.Кейс.ДескрипторБенчмарка();
 
-КонецФункции
+	Наименование = Дескриптор.Наименование();
+	Если ЗначениеЗаполнено(Наименование) Тогда
+		Возврат Наименование;
+	КонецЕсли;
+
+	Возврат Дескриптор.Метод();
+
+КонецФункции

tests/fixtures/benchmarks/Классы/БенчмаркСНаименованием.os

@@ -0,0 +1,7 @@
+&Бенчмарк(Наименование = "Тестовое наименование бенчмарка")
+Процедура БенчмаркСНаименованием() Экспорт
+КонецПроцедуры
+
+&Бенчмарк
+Процедура БенчмаркБезНаименования() Экспорт
+КонецПроцедуры

tests/ТестыБенчмарков.os

@@ -220,7 +220,8 @@
 		.ДобавитьИсточникПараметров("Источник1")
 		.ДобавитьИсточникПараметров("Источник2")
 		.ИспользоватьКакЭталон()
-		.УстановитьКатегорию("Категория");
+		.УстановитьКатегорию("Категория")
+		.УстановитьНаименование("Наименование для копии");
 
 	// Действие
 	КопияДескриптора = Дескриптор.Скопировать();
@@ -235,6 +236,7 @@
 	Ожидаем.Что(НаборыПараметров[1].Получить(1).Значение()).Равно(200);
 	Ожидаем.Что(КопияДескриптора.ЭтоЭталон()).ЭтоИстина();
 	Ожидаем.Что(КопияДескриптора.Категория()).Равно("Категория");
+	Ожидаем.Что(КопияДескриптора.Наименование()).Равно("Наименование для копии");
 	Ожидаем.Что(ИсточникиПараметров[0]).Равно("Источник1");
 	Ожидаем.Что(ИсточникиПараметров[1]).Равно("Источник2");
 
@@ -655,4 +657,59 @@
 		.Метод("Запустить", ПараметрыМетода)
 		.ВыбрасываетИсключение("Не найдено ни одного дескриптора бенчмарка для запуска");
 
-КонецПроцедуры
+КонецПроцедуры
+
+&Тест
+Процедура ТестДолжен_ИзвлечьНаименованиеИзАннотацииБенчмарк() Экспорт
+	
+	// Подготовка
+	Тип = Тип("БенчмаркСНаименованием");
+
+	// Действие
+	ДескрипторыБенчмарков = Новый КоллекцияДескрипторовБенчмарков(Тип);
+
+	// Проверка
+	ДескрипторСНаименованием = ДескрипторыБенчмарков.НайтиПоИмени("БенчмаркСНаименованием");
+	ДескрипторБезНаименования = ДескрипторыБенчмарков.НайтиПоИмени("БенчмаркБезНаименования");
+
+	Ожидаем.Что(ДескрипторСНаименованием.Наименование()).Равно("Тестовое наименование бенчмарка");
+	Ожидаем.Что(ДескрипторБезНаименования.Наименование()).Равно("");
+
+КонецПроцедуры
+
+&Тест
+Процедура ТестДолжен_УстановитьНаименованиеЧерезМетодДескриптора() Экспорт
+	
+	// Подготовка
+	Тип = Тип("ПустойБенчмарк");
+
+	ДескрипторыБенчмарков = Новый КоллекцияДескрипторовБенчмарков(Тип);
+	Дескриптор = ДескрипторыБенчмарков.ПолучитьПервый();
+
+	// Действие
+	Дескриптор.УстановитьНаименование("Мое наименование");
+
+	// Проверка
+	Ожидаем.Что(Дескриптор.Наименование()).Равно("Мое наименование");
+
+КонецПроцедуры
+
+&Тест
+Процедура ТестДолжен_ВключитьНаименованиеВОтчет() Экспорт
+	
+	// Подготовка
+	Конфигурация = ТестированиеБенчмарков.КонфигурацияПоУмолчанию();
+
+	// Действие
+	Результат = Бенчмаркинг.Запустить(Тип("БенчмаркСНаименованием"), Конфигурация);
+
+	// Проверка
+	Ожидаем.Что(Результат.Отчет.Таблица).ИмеетДлину(2);
+
+	ДескрипторСНаименованием = Результат.Отчет.Таблица[0];
+	ДескрипторБезНаименования = Результат.Отчет.Таблица[1];
+
+	Ожидаем.Что(ДескрипторСНаименованием[КолонкиОтчетаБенчмарков.Метод]).Равно("Тестовое наименование бенчмарка");
+	Ожидаем.Что(ДескрипторБезНаименования[КолонкиОтчетаБенчмарков.Метод]).Равно("БенчмаркБезНаименования");
+
+КонецПроцедуры