Describe filtering by test type

Author: roxblnfk

docs/cli-reference.md

@@ -1,5 +1,5 @@
 ---
-llms_description: "CLI commands and flags: testo run, --config, --teamcity, --suite, --path, --filter, filter combination logic, exit codes"
+llms_description: "CLI commands and flags: testo run, --config, --teamcity, --suite, --path, --filter, --type, filter combination logic, exit codes"
 ---
 
 # Command Line Interface
@@ -71,7 +71,7 @@ Testo provides three types of filters that can be combined to selectively run te
 **Filter Combination Logic:**
 - Same type filters use OR logic: `--filter=test1 --filter=test2` → test1 OR test2
 - Different type filters use AND logic: `--filter=test1 --suite=Unit` → test1 AND Unit
-- Formula: `AND(OR(filters), OR(paths), OR(suites))`
+- Formula: `AND(OR(filters), OR(paths), OR(suites), type)`
 
 For detailed information about filtering behavior, see [Filtering](/docs/filtering).
 
@@ -150,6 +150,35 @@ testo run --filter=UserTest --path="tests/Unit"
 
 **Filter Behavior:** See [Filtering](/docs/filtering) for details.
 
+#### `--type`
+
+Filter tests by type. If specified, only tests of the matching type are run.
+
+**Possible values:**
+- `test` — regular tests (methods in classes)
+- `inline` — [inline tests](/docs/inline-tests) (tests via `#[TestInline]`)
+- `bench` — benchmarks
+
+**Examples:**
+```bash
+# Regular tests only
+testo run --type=test
+
+# Inline tests only
+testo run --type=inline
+
+# Benchmarks only
+testo run --type=bench
+
+# Combine with other filters
+testo run --type=test --suite=Unit
+testo run --type=inline --filter=testLogin
+```
+
+::: info Middleware and test types
+Middleware bound to a specific test type is excluded from the pipeline if the type doesn't match the one specified in `--type`.
+:::
+
 ### Combining Filters
 
 **Examples:**

docs/filtering.md

@@ -19,6 +19,7 @@ $filter = new Filter(
     suites: ['Unit', 'Integration'],
     names: ['UserTest::testLogin', 'testAuthentication'],
     paths: ['tests/Unit/*', 'tests/Integration/*'],
+    type: 'test',
 );
 ```
 
@@ -44,6 +45,12 @@ $filter = new Filter(
 - File or directory paths to filter by
 - Supports glob patterns: `*`, `?`, `[abc]`
 
+**`type`**: `?non-empty-string`
+- Test type to filter by
+- Possible values: `test` (regular tests), `inline` (inline tests), `bench` (benchmarks), or other custom types
+- If not specified — all test types are run
+- Middleware bound to a specific type won't enter the pipeline if the type doesn't match
+
 ### Usage with Application
 
 The `Filter` object can be passed to `Application::run()`:
@@ -77,17 +84,19 @@ Different filter types are combined with AND logic:
 
 - `names: ['test1'], suites: ['Unit']` → matches if name is test1 **AND** suite is Unit
 - `names: ['UserTest'], paths: ['tests/Unit/*']` → matches if name is UserTest **AND** path matches tests/Unit/*
+- `names: ['test1'], type: 'inline'` → matches if name is test1 **AND** type is inline
 
-**Formula**: `AND(OR(names), OR(paths), OR(suites))`
+**Formula**: `AND(OR(names), OR(paths), OR(suites), type)`
 
 **Example:**
 ```php
 $filter = new Filter(
     names: ['test1', 'test2'],        // test1 OR test2
     paths: ['path1', 'path2'],        // path1 OR path2
-    suites: ['Unit', 'Critical'], // Unit OR Critical
+    suites: ['Unit', 'Critical'],     // Unit OR Critical
+    type: 'test',                     // regular tests only
 );
-// Result: (test1 OR test2) AND (path1 OR path2) AND (Unit OR Critical)
+// Result: (test1 OR test2) AND (path1 OR path2) AND (Unit OR Critical) AND type=test
 ```
 
 ## Name Filter Behavior

ru/docs/cli-reference.md

@@ -67,7 +67,7 @@ Testo предоставляет три типа фильтров, которы
 **Логика комбинирования фильтров:**
 - Фильтры одного типа используют логику ИЛИ: `--filter=test1 --filter=test2` → test1 ИЛИ test2
 - Фильтры разных типов используют логику И: `--filter=test1 --suite=Unit` → test1 И Unit
-- Формула: `И(ИЛИ(filters), ИЛИ(paths), ИЛИ(suites))`
+- Формула: `И(ИЛИ(filters), ИЛИ(paths), ИЛИ(suites), type)`
 
 Подробная информация о поведении фильтров в разделе [Фильтрация](/ru/docs/filtering).
 
@@ -146,6 +146,35 @@ testo run --filter=UserTest --path="tests/Unit"
 
 **Поведение фильтров:** Подробности в разделе [Фильтрация](/ru/docs/filtering).
 
+#### `--type`
+
+Фильтрация тестов по типу. Если указан, запускаются только тесты соответствующего типа.
+
+**Возможные значения:**
+- `test` — обычные тесты (методы в классах)
+- `inline` — [встроенные тесты](/ru/docs/inline-tests) (тесты через `#[TestInline]`)
+- `bench` — бенчмарки
+
+**Примеры:**
+```bash
+# Только обычные тесты
+testo run --type=test
+
+# Только встроенные тесты
+testo run --type=inline
+
+# Только бенчмарки
+testo run --type=bench
+
+# Комбинация с другими фильтрами
+testo run --type=test --suite=Unit
+testo run --type=inline --filter=testLogin
+```
+
+::: info Мидлвари и тип тестов
+Мидлвари, привязанные к определённому типу тестов, исключаются из пайплайна, если тип не совпадает с указанным в `--type`.
+:::
+
 ### Комбинирование фильтров
 
 **Примеры:**

ru/docs/filtering.md

@@ -15,6 +15,7 @@ $filter = new Filter(
     suites: ['Unit', 'Integration'],
     names: ['UserTest::testLogin', 'testAuthentication'],
     paths: ['tests/Unit/*', 'tests/Integration/*'],
+    type: 'test',
 );
 ```
 
@@ -40,6 +41,12 @@ $filter = new Filter(
 - Пути к файлам или директориям для фильтрации
 - Поддерживает glob-паттерны: `*`, `?`, `[abc]`
 
+**`type`**: `?non-empty-string`
+- Тип тестов для фильтрации
+- Возможные значения: `test` (обычные тесты), `inline` (встроенные тесты), `bench` (бенчмарки), или другие пользовательские типы
+- Если не указан — запускаются все типы тестов
+- Мидлвари, привязанные к определённому типу, не попадут в пайплайн, если тип не совпадает
+
 ### Использование с Application
 
 Объект `Filter` может быть передан в `Application::run()`:
@@ -73,17 +80,19 @@ $result = $app->run($filter);
 
 - `names: ['test1'], suites: ['Unit']` → совпадает, если имя test1 **И** Test Suite - Unit
 - `names: ['UserTest'], paths: ['tests/Unit/*']` → совпадает, если имя UserTest **И** путь соответствует tests/Unit/*
+- `names: ['test1'], type: 'inline'` → совпадает, если имя test1 **И** тип - inline
 
-**Формула**: `AND(OR(names), OR(paths), OR(suites))`
+**Формула**: `AND(OR(names), OR(paths), OR(suites), type)`
 
 **Пример:**
 ```php
 $filter = new Filter(
     names: ['test1', 'test2'],        // test1 ИЛИ test2
     paths: ['path1', 'path2'],        // path1 ИЛИ path2
-    suites: ['Unit', 'Critical'], // Unit ИЛИ Critical
+    suites: ['Unit', 'Critical'],     // Unit ИЛИ Critical
+    type: 'test',                     // только обычные тесты
 );
-// Результат: (test1 ИЛИ test2) И (path1 ИЛИ path2) И (Unit ИЛИ Critical)
+// Результат: (test1 ИЛИ test2) И (path1 ИЛИ path2) И (Unit ИЛИ Critical) И type=test
 ```
 
 ## Поведение фильтра по именам