Add option --filter-class-name

Author: andrey-tech

src/PHPUnit/Cobertura/Formatter/Application.php

@@ -19,6 +19,7 @@
 use Exception;
 use Symfony\Component\Console\Output\ConsoleOutput;
 use Throwable;
+use AndreyTech\PHPUnit\Cobertura\Formatter\Parser\Filter\ClassName as ClassNameFilter;
 
 use function sprintf;
 
@@ -62,6 +63,8 @@ public function run(): int
      */
     private function doRun(): int
     {
+        $this->commandLine->buildInputArgs();
+
         $this->consoleOutput->getFormatter()->setDecorated(!$this->commandLine->optionNoColor());
 
         if ($this->commandLine->optionInit()) {
@@ -86,9 +89,13 @@ private function parseAndRender(): void
                 new ConfigFile()
             )
         ))->render(
-            (new Parser())->parse(
-                new CoberturaFile(
-                    $this->commandLine->coberturaFile()
+            (new ClassNameFilter(
+                $this->commandLine->optionFilterClassName()
+            ))->filter(
+                (new Parser())->parse(
+                    new CoberturaFile(
+                        $this->commandLine->coberturaFile()
+                    )
                 )
             )
         );

src/PHPUnit/Cobertura/Formatter/Config/CommandLine.php

@@ -17,16 +17,16 @@
 use Symfony\Component\Console\Input\InputDefinition;
 use Symfony\Component\Console\Input\InputOption;
 
-final readonly class CommandLine
+final class CommandLine
 {
     private ArgvInput $input;
 
     public function __construct()
     {
-        $this->input = $this->buildArgvInput();
+        $this->input = new ArgvInput();
     }
 
-    public function buildArgvInput(): ArgvInput
+    public function buildInputArgs(): void
     {
         $definition = new InputDefinition();
 
@@ -39,15 +39,18 @@ public function buildArgvInput(): ArgvInput
         $option = new InputOption('no-color', null, InputOption::VALUE_NONE);
         $definition->addOption($option);
 
-        return new ArgvInput(null, $definition);
+        $option = new InputOption('filter-class-name', null, InputOption::VALUE_REQUIRED);
+        $definition->addOption($option);
+
+        $this->input = new ArgvInput(null, $definition);
     }
 
     public function coberturaFile(): string
     {
         $coberturaFile = (string) $this->input->getArgument('cobertura-file');
 
         if ('' === $coberturaFile) {
-            throw new RuntimeException('Missing required argument <path to cobertura XML file>.');
+            throw new RuntimeException('Missing required argument \'path to cobertura XML file\'.');
         }
 
         return $coberturaFile;
@@ -62,4 +65,20 @@ public function optionNoColor(): bool
     {
         return (bool) $this->input->getOption('no-color');
     }
+
+    public function optionFilterClassName(): ?string
+    {
+        /** @var string|null $filterClassName */
+        $filterClassName = $this->input->getOption('filter-class-name');
+
+        if (null === $filterClassName) {
+            return null;
+        }
+
+        if ('' === $filterClassName) {
+            throw new RuntimeException('The "--filter-class-name" option requires a value.');
+        }
+
+        return $filterClassName;
+    }
 }

src/PHPUnit/Cobertura/Formatter/Parser/ClassMetricsCollection.php

@@ -11,12 +11,20 @@
 
 namespace AndreyTech\PHPUnit\Cobertura\Formatter\Parser;
 
+use Closure;
+
+use function array_filter;
+use function array_values;
+
 final class ClassMetricsCollection
 {
     /**
-     * @var list<ClassMetrics>
+     * @param list<ClassMetrics> $items
      */
-    private array $items = [];
+    public function __construct(
+        private array $items = []
+    ) {
+    }
 
     public function add(ClassMetrics $classMetrics): void
     {
@@ -30,4 +38,16 @@ public function all(): array
     {
         return $this->items;
     }
+
+    /**
+     * @param Closure(ClassMetrics):bool $closure
+     */
+    public function filter(Closure $closure): self
+    {
+        return new self(
+            array_values(
+                array_filter($this->items, $closure)
+            )
+        );
+    }
 }

src/PHPUnit/Cobertura/Formatter/Parser/Filter/ClassName.php

@@ -0,0 +1,42 @@
+<?php
+
+/**
+ * @author    andrey-tech
+ * @copyright 2025 andrey-tech
+ * @link      https://github.com/andrey-tech/
+ * @license   MIT
+ */
+
+declare(strict_types=1);
+
+namespace AndreyTech\PHPUnit\Cobertura\Formatter\Parser\Filter;
+
+use AndreyTech\PHPUnit\Cobertura\Formatter\Parser\ClassMetrics;
+use AndreyTech\PHPUnit\Cobertura\Formatter\Parser\ClassMetricsCollection;
+
+use function preg_match;
+use function sprintf;
+
+final readonly class ClassName
+{
+    public function __construct(
+        private ?string $classNameRegex
+    ) {
+    }
+
+    public function filter(ClassMetricsCollection $classMetricsCollection): ClassMetricsCollection
+    {
+        $regex = $this->classNameRegex;
+
+        if (null === $regex || '' === $regex) {
+            return $classMetricsCollection;
+        }
+
+        return $classMetricsCollection->filter(
+            static fn (ClassMetrics $classMetrics): bool => (bool) preg_match(
+                sprintf('|%s|', $regex),
+                $classMetrics->name
+            )
+        );
+    }
+}