Add blog-post Filters

roxblnfk · roxblnfk · commit 26039a392cf3 · 2026-01-09T10:04:24.000+04:00
diff --git a/blog/assert-and-expect.md b/blog/assert-and-expect.md
@@ -59,7 +59,7 @@ Then we got to `Assert::greaterThan()`. In PHPUnit, the argument order is the sa
 
 So if we want to say `$foo is greater than 42`, we have to write `greaterThan(42, $foo)`.
 
-![greaterThan](/blog/assert-and-expect/img-2.jpg)
+![Exceed forty-two, $foo must. Sense this, I do.](/blog/assert-and-expect/img-2.jpg)
 
 Looks disgusting, since everywhere else we use mathematical notation like `$foo > 42`.
 
@@ -124,7 +124,7 @@ This way, at the start of the pipe in `Assert::string()`, we immediately verify
 
 Code takes less space, facades aren't bloated. Now this is what looks truly elegant. Whether it's usable or not — practice will tell.
 
-![Pipe assertions](/blog/assert-and-expect/img-4.jpg)
+![Cool. I like it!](/blog/assert-and-expect/img-4.jpg)
 
 ---
 
diff --git a/blog/filters.md b/blog/filters.md
@@ -0,0 +1,45 @@
+# Testo. Filters
+
+![Filters](/blog/filters/img-1.jpg)
+
+Filters are needed to narrow down the set of tests to run. In other words, it's the ability to select tests before running them.
+
+Adding filters is one of the important milestones on the road to version 1.0.0
+
+Now we can proudly say that this milestone is closed. Filters are supported at both the framework level and the plugin level.
+
+![Filters in plugin](/blog/filters/img-2.jpg)
+
+**The filtering system in** [Testo](https://github.com/php-internal/testo) **is multi-layered.**
+
+1. **Test Suite** (`--suite` flag) — global level. It's better to immediately specify that we're running **Unit** tests and don't need to go into **Acceptance**. This will cut out a large chunk of work for the next level.
+
+2. **File path** (`--path` flag) — works at the Finder level, when the folder and file structure is simply scanned. Supports wildcards (asterisks, question marks, etc.).
+
+3. Tokenization. Files that passed the previous filters begin to be read and split into tokens.
+
+    These tokens are used to search for function, method, and class names. This is not yet file execution and reflection is unavailable here, but we can already understand whether there are tests in these files.
+
+    At this stage, the **name filter** for a test or test case works (in CLI: `--filter` flag).
+
+    You can specify a short name of a function, method, class, or together (`UserTest::testCreate`), or FQN (fully qualified name) of a function/class/method.
+
+4. After tokenization, files are executed by PHP so we can work with reflection.
+
+   At the reflection level, the filter system performs its final actions: it doesn't let through tests or cases that don't match the name filter.
+
+**Filters can be combined.**
+
+Same-type filters are combined with **OR** operator, different-type filters with **AND** operator.
+
+For example:
+
+- if you specify only two files, both will be executed, since they pass the criteria (File1 OR File2)
+
+- if you specify a file path and the name `simpleTest`, only simpleTest from the specified file will be executed.
+
+**Plugin**
+
+On the [plugin](https://plugins.jetbrains.com/plugin/28842-testo) side, you can now click on a test case, a test, or a file and run only what's selected. And [@xepozz](https://boosty.to/xepozz) also added the ability to hide unnecessary stack traces under a spoiler. Looks amazing and very convenient.
+
+![Plugin in action](/blog/filters/img-3.jpg)
diff --git a/blog/filters/img-1.jpg b/blog/filters/img-1.jpg
diff --git a/blog/filters/img-2.jpg b/blog/filters/img-2.jpg
diff --git a/blog/filters/img-3.jpg b/blog/filters/img-3.jpg
diff --git a/blog/index.md b/blog/index.md
@@ -5,4 +5,5 @@ Latest news and articles about Testo.
 ## Articles
 
 - `2026-01-01` [Assert and Expect](./assert-and-expect.md)
+- `2025-11-07` [Filters](./filters.md)
 - `2025-10-30` [Khinkali](./khinkali.md)
diff --git a/ru/blog/assert-and-expect.md b/ru/blog/assert-and-expect.md
@@ -58,7 +58,7 @@ function simpleTest(): void
 
 Т.е. если мы хотим сказать `$foo больше 42`, то надо написать `greaterThan(42, $foo)`.
 
-![greaterThan](/blog/assert-and-expect/img-2-ru.jpg)
+![Превосходить сорок два $foo должно, чую я](/blog/assert-and-expect/img-2-ru.jpg)
 
 Выглядит отвратительно, ведь везде используем математическую запись вида `$foo > 42`.
 
@@ -99,7 +99,7 @@ Assert::true($foo > 42);
 
 - Нет автокомплита по фасаду `Assert`, и нужно помнить про второй фасад. Ну, к этому надо будет просто привыкнуть.
 
-![Мем](/blog/assert-and-expect/img-3.jpg)
+![Мем](/blog/assert-and-expect/img-3-ru.jpg)
 
 
 ## Пробуем что-то новое
@@ -123,7 +123,7 @@ Expect::exception(Failure::class)
 
 Код занимает меньше места, фасады не раздутые. Вот это то, что выглядит действительно элегантно. А юзабельно или нет, покажет практика.
 
-![Пайповые ассерты](/blog/assert-and-expect/img-4-ru.jpg)
+![Здорово. Мне нравится.](/blog/assert-and-expect/img-4-ru.jpg)
 
 
 ---
diff --git a/ru/blog/filters.md b/ru/blog/filters.md
@@ -0,0 +1,45 @@
+# Testo. Фильтры
+
+![Фильтры](/blog/filters/img-1.jpg)
+
+Фильтры нужны для того, чтобы сузить множество запускаемых тестов. Иначе говоря, это возможность сделать выборку по тестам перед их запуском.
+
+Добавление фильтров является одним из важных пунктов на пути к версии 1.0.0
+
+Теперь с гордостью можно сказать, что этот пункт закрыт. Фильтры поддерживаются на уровне фреймворка и на уровне плагина.
+
+![Фильтры в плагине](/blog/filters/img-2.jpg)
+
+**Система фильтрации в** [Testo](https://github.com/php-internal/testo) **многослойная.**
+
+1. **Test Suite** (флаг `--suite`) — глобальный уровень. Лучше сразу обозначить, что мы запускаем **Unit** тест и лезть в **Acceptance** не нужно. Это срежет большой пласт работы для следующего уровня.
+
+2. **Путь до файла** (флаг `--path`) — отрабатывает на уровне Finder'а, когда просто сканируется структура папок и файлов. Поддерживает wildcards (звёздочки, вопросики и т.д.).
+
+3. Токенизация. Файлы, прошедшие предыдущие фильтры начинают читаться и разбиваться на токены.
+
+    По этим токенам ищутся имена функций, методов и классов. Это ещё не исполнение файла и рефлексия здесь недоступна, но мы уже можем понять, есть ли в этих файлах тесты.
+
+    На этом этапе отрабатывает **фильтр по имени** теста или тест-кейса (в CLI флаг `--filter`).
+
+    Можно указать короткое имя функции, метода, класса или вместе (`UserTest::testCreate`), либо FQN (полное имя) функции/класса/метода.
+
+4. После токенизации файлы выполняются пыхой, чтобы мы могли работать с рефлексией.
+
+   На уровне рефлексии система фильтров выполняет последние действия: не пропускает дальше те тесты или кейсы, которые не подходят под фильтр по имени.
+
+**Фильтры можно комбинировать.**
+
+Однотипные фильтры комбинируются оператором **ИЛИ**, разнотипные оператором **И**.
+
+Например:
+
+- если указать только два файла, то выполнятся оба, т.к. пройдут по критерию (Файл1 ИЛИ Файл2)
+
+- если указать путь до файла и имя `simpleTest`, то выполнится только simpleTest из указанного файла.
+
+**Плагин**
+
+На стороне [плагина](https://plugins.jetbrains.com/plugin/28842-testo) теперь можно кликнуть на тест-кейс, на тест или на файл и запустить только выбранное. А ещё [@xepozz](https://boosty.to/xepozz) добавил сокрытие ненужных стек-трейсов под спойлер. Выглядит офигенно и очень удобно.
+
+![Плагин в действии](/blog/filters/img-3.jpg)
diff --git a/ru/blog/index.md b/ru/blog/index.md
@@ -5,4 +5,5 @@
 ## Статьи
 
 - `2026-01-01` [Assert и Expect](./assert-and-expect)
+- `2025-11-07` [Фильтры](./filters)
 - `2025-10-30` [Хинкали](./khinkali)
