Skip to content

Commit 9df4caa

Browse files
committed
Refine terminology in filtering and CLAUDE documentation for consistency and clarity
1 parent 4dff0fd commit 9df4caa

File tree

2 files changed

+27
-18
lines changed

2 files changed

+27
-18
lines changed

CLAUDE.md

Lines changed: 16 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,15 @@
1414

1515
### Устоявшиеся термины
1616

17-
| Английский | ❌ Неправильно | ✅ Правильно |
18-
|------------|----------------|--------------|
19-
| test case | тестовый случай | тест, тест-кейс |
20-
| data provider | поставщик данных | провайдер данных |
21-
| dataset || датасет / набор данных (оба допустимы) |
22-
| callable | вызываемый | вызываемый объект (в контексте) |
23-
| closure | закрытие | замыкание |
17+
| Английский | ❌ Неправильно | ✅ Правильно | Примечание |
18+
|------------|----------------|--------------|------------|
19+
| test || тест | Один метод теста или InlineTest |
20+
| test case | тестовый случай | Test Case / тест-кейс / тестовый класс / класс тестов / набор тестов | Класс/файл с тестами. Выбор зависит от контекста |
21+
| test suite | тестовый набор | Test Suite / комплект тестов | Глобальная группа (Unit, Feature). Предпочтительно без перевода |
22+
| data provider | поставщик данных | провайдер данных | |
23+
| dataset || датасет / набор данных | Оба допустимы |
24+
| callable | вызываемый | вызываемый объект | В контексте |
25+
| closure | закрытие | замыкание | |
2426

2527
### Специфичные фразы
2628

@@ -43,6 +45,13 @@
4345
- Использовать естественный русский порядок слов
4446
- Не копировать английскую структуру предложения
4547

48+
4. **Термин + конкретное значение**
49+
- При упоминании технического термина с конкретным значением использовать дефис для разделения
50+
- Примеры:
51+
- ✅ "Test Suite - Unit" (не "Test Suite Unit")
52+
- ✅ "комплект тестов Unit" (альтернатива)
53+
- ✅ "провайдер данных - UserDataProvider"
54+
4655
## Проверка качества
4756

4857
Перед финализацией перевода задать вопросы:

ru/docs/filtering.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ $filter = new Filter(
2323
### Свойства
2424

2525
**`testSuites`**: `list<non-empty-string>`
26-
- Названия наборов тестов для фильтрации
27-
- Используется на Этапе 1 для определения, какие области конфигурации загружать
26+
- Названия Test Suite для фильтрации
27+
- Используется на Этапе 1 для определения, какие Test Suite загружать
2828

2929
**`names`**: `list<non-empty-string>`
3030
- Имена классов, методов или функций для фильтрации
@@ -33,7 +33,7 @@ $filter = new Filter(
3333
- FQN: `Namespace\ClassName` или `Namespace\functionName`
3434
- Фрагмент: `methodName`, `functionName` или `ShortClassName`
3535
- Опциональные индексы DataProvider: `name:providerIndex:datasetIndex`
36-
- Предоставляет индексы для модуля data provider
36+
- Предоставляет индексы для модуля провайдера данных
3737
- Индексы начинаются с 0 и независимы от меток наборов данных
3838
- `datasetIndex` опционален (можно опустить, чтобы передать только индекс provider)
3939
- Примеры: `UserTest::testLogin:0`, `testAuth:1:3`, `UserTest:0`
@@ -70,13 +70,13 @@ $result = $app->run($filter);
7070

7171
- `names: ['test1', 'test2']` → совпадает, если имя test1 **ИЛИ** test2
7272
- `paths: ['path1', 'path2']` → совпадает, если путь path1 **ИЛИ** path2
73-
- `suites: ['Unit', 'Integration']` → совпадает, если набор Unit **ИЛИ** Integration
73+
- `suites: ['Unit', 'Integration']` → совпадает, если Test Suite - Unit **ИЛИ** Integration
7474

7575
### Разные типы: логика И
7676

7777
Разные типы фильтров комбинируются логикой И:
7878

79-
- `names: ['test1'], suites: ['Unit']` → совпадает, если имя test1 **И** набор Unit
79+
- `names: ['test1'], suites: ['Unit']` → совпадает, если имя test1 **И** Test Suite - Unit
8080
- `names: ['UserTest'], paths: ['tests/Unit/*']` → совпадает, если имя UserTest **И** путь соответствует tests/Unit/*
8181

8282
**Формула**: `AND(OR(names), OR(paths), OR(suites))`
@@ -105,7 +105,7 @@ $filter = new Filter(
105105
**Пример:**
106106
```php
107107
$filter = new Filter(names: ['UserTest::testLogin']);
108-
// Результат: класс UserTest с только методом testLogin
108+
// Результат: класс UserTest только с методом testLogin
109109
```
110110

111111
### Формат FQN или фрагмента
@@ -137,7 +137,7 @@ $filter = new Filter(names: ['testLogin']);
137137

138138
### Индексы DataProvider
139139

140-
Когда тесты используют data provider, имена могут включать индексы provider и dataset с использованием разделителя двоеточие. Эти индексы становятся доступны модулю data provider.
140+
Когда тесты используют провайдер данных, имена могут включать индексы provider и dataset с использованием разделителя двоеточие. Эти индексы становятся доступны модулю провайдера данных.
141141

142142
**Формат:** `name:providerIndex:datasetIndex`
143143

@@ -164,14 +164,14 @@ $filter = new Filter(names: ['UserTest:0']);
164164

165165
Фильтрация работает в пять этапов:
166166

167-
### Этап 1: Фильтр набора (уровень конфигурации)
167+
### Этап 1: Фильтр Test Suite (уровень конфигурации)
168168

169169
**Входные данные:** `Filter::$suites`
170170

171-
- Фильтрует области конфигурации на основе названий наборов
172-
- Каждый набор определяет расположение и паттерны сканирования файлов
171+
- Фильтрует Test Suite по названиям
172+
- Каждый Test Suite определяет расположение и паттерны сканирования файлов
173173
- Определяет начальный набор директорий для сканирования
174-
- Несколько наборов используют логику ИЛИ
174+
- Несколько Test Suite используют логику ИЛИ
175175

176176
### Этап 2: Фильтр путей (уровень Finder)
177177

0 commit comments

Comments
 (0)