Describe DataSet attribute

Author: roxblnfk

docs/data-providers.md

@@ -1,6 +1,31 @@
 # Data Providers
 
-`DataProvider` lets you specify a method or callable that returns test data. Each data set from the provider runs as a separate test:
+Data providers let you run one test with different sets of input data. Each set runs as a separate test.
+
+## DataSet
+
+The simplest way — specify data directly above the method:
+
+```php
+use Testo\Attribute\Test;
+use Testo\Attribute\DataSet;
+
+#[Test]
+#[DataSet([1, 1, 2])]
+#[DataSet([2, 3, 5])]
+#[DataSet([0, 0, 0])]
+public function testSum(int $a, int $b, int $expected): void
+{
+    Assert::same($expected, $a + $b);
+}
+```
+
+Each `DataSet` is an array of arguments passed to the test method. The test runs three times with different values.
+
+
+## DataProvider
+
+For large amounts of data or dynamic generation, use `DataProvider`. It accepts a method or callable that returns test data:
 
 ```php
 use Testo\Attribute\Test;
@@ -55,26 +80,3 @@ public function testUser($data): void { ... }
 ```
 
 Invokable objects are particularly useful for separating data loading logic. For example, loading test cases from JSON/CSV files into a dedicated class keeps your test code clean.
-
-### Labels and Descriptions
-
-Each data set can be labeled with a string key. These labels appear in test reports, making it easier to identify which scenario failed:
-
-```php
-public function userDataProvider(): array
-{
-    return [
-        'valid email' => ['test@example.com', true],
-        'invalid format' => ['not-an-email', false],
-        'empty string' => ['', false],
-    ];
-}
-```
-
-Use `DataProvider` when:
-- You have many test cases (10+)
-- Data is generated dynamically or loaded from external files
-- Test cases need labels or descriptions for clarity
-- You need complex setup logic for test data
-
-**Note:** `DataProvider` is an addition to regular tests (methods marked with `#[Test]`). It provides data to existing test methods.

ru/docs/data-providers.md

@@ -1,6 +1,31 @@
 # Провайдеры данных
 
-`DataProvider` позволяет указать метод или вызываемый объект, который возвращает тестовые данные. Каждый набор данных от провайдера запускается как отдельный тест:
+Провайдеры данных позволяют запускать один тест с разными наборами входных данных. Каждый набор — отдельный запуск теста.
+
+## DataSet
+
+Самый простой способ — указать данные прямо над методом:
+
+```php
+use Testo\Attribute\Test;
+use Testo\Attribute\DataSet;
+
+#[Test]
+#[DataSet([1, 1, 2])]
+#[DataSet([2, 3, 5])]
+#[DataSet([0, 0, 0])]
+public function testSum(int $a, int $b, int $expected): void
+{
+    Assert::same($expected, $a + $b);
+}
+```
+
+Каждый `DataSet` — массив аргументов, которые передаются в тестовый метод. Тест запустится три раза с разными значениями.
+
+
+## DataProvider
+
+Для большого количества данных или динамической генерации используйте `DataProvider`. Он принимает метод или вызываемый объект, который возвращает тестовые данные:
 
 ```php
 use Testo\Attribute\Test;
@@ -55,26 +80,3 @@ public function testUser($data): void { ... }
 ```
 
 Вызываемые объекты особенно полезны для разделения логики загрузки данных. Например, загрузка тестов из JSON/CSV файлов в выделенный класс позволяет сохранить код тестов чистым.
-
-### Метки и описания
-
-Каждый набор данных может быть помечен строковым ключом. Эти метки отображаются в отчетах о тестах, упрощая определение того, какой сценарий не прошел:
-
-```php
-public function userDataProvider(): array
-{
-    return [
-        'valid email' => ['test@example.com', true],
-        'invalid format' => ['not-an-email', false],
-        'empty string' => ['', false],
-    ];
-}
-```
-
-Используйте `DataProvider`, когда:
-- У вас много тестов (10+)
-- Данные генерируются динамически или загружаются из внешних файлов
-- Тестам нужны метки или описания для ясности
-- Требуется сложная логика настройки для тестовых данных
-
-**Примечание:** `DataProvider` является дополнением к обычным тестам (методам, помеченным `#[Test]`). Он предоставляет данные существующим тестовым методам.