* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace PHPUnit\Runner\Filter; use function assert; use FilterIterator; use Iterator; use PHPUnit\Framework\TestSuite; use ReflectionClass; /** * @no-named-arguments Parameter names are not covered by the backward compatibility promise for PHPUnit * * @internal This class is not covered by the backward compatibility promise for PHPUnit */ final class Factory { /** * @psalm-var array */ private array $filters = []; /** * @psalm-param list $testIds */ public function addTestIdFilter(array $testIds): void { $this->filters[] = [ new ReflectionClass(TestIdFilterIterator::class), $testIds, ]; } /** * @psalm-param list $groups */ public function addExcludeGroupFilter(array $groups): void { $this->filters[] = [ new ReflectionClass(ExcludeGroupFilterIterator::class), $groups, ]; } /** * @psalm-param list $groups */ public function addIncludeGroupFilter(array $groups): void { $this->filters[] = [ new ReflectionClass(IncludeGroupFilterIterator::class), $groups, ]; } /** * @psalm-param non-empty-string $name */ public function addNameFilter(string $name): void { $this->filters[] = [ new ReflectionClass(NameFilterIterator::class), $name, ]; } public function factory(Iterator $iterator, TestSuite $suite): FilterIterator { foreach ($this->filters as $filter) { [$class, $arguments] = $filter; $iterator = $class->newInstance($iterator, $arguments, $suite); } assert($iterator instanceof FilterIterator); return $iterator; } }