Add --testdox-summary support (#1032)

Author: Slamdunk

src/Options.php

@@ -558,6 +558,12 @@ public static function setInputDefinition(InputDefinition $inputDefinition): voi
                 InputOption::VALUE_NONE,
                 '@see PHPUnit guide, chapter: ' . $chapter,
             ),
+            new InputOption(
+                'testdox-summary',
+                null,
+                InputOption::VALUE_NONE,
+                '@see PHPUnit guide, chapter: ' . $chapter,
+            ),
             new InputOption(
                 'log-junit',
                 null,

test/Unit/WrapperRunner/WrapperRunnerTest.php

@@ -281,6 +281,28 @@ public function testTestdoxOutput(): void
         );
     }
 
+    public function testTestdoxOutputWithSummary(): void
+    {
+        $this->bareOptions['path']              = $this->fixture('common_results');
+        $this->bareOptions['--testdox']         = true;
+        $this->bareOptions['--testdox-summary'] = true;
+
+        $result = $this->runRunner();
+
+        $format = file_get_contents(__DIR__ . '/fixtures/common_results_testdox_with_summary_output');
+        self::assertNotFalse($format);
+
+        $output = $result->output;
+        $output = preg_replace("/^Processes:     \\d+\nRuntime:       PHP \\d+\\.\\d+\\.\\w+(-.+)?\n\n/", '', $output, 1, $count);
+        self::assertSame(1, $count);
+        self::assertNotNull($output);
+
+        self::assertStringMatchesFormat(
+            $format,
+            $output,
+        );
+    }
+
     public function testTestdoxTextLog(): void
     {
         $outputPath = $this->tmpDir . DIRECTORY_SEPARATOR . 'testdox-output.text';

test/Unit/WrapperRunner/fixtures/common_results_testdox_with_summary_output

@@ -0,0 +1,75 @@
+EFIRS.W                                                             7 / 7 (100%)
+
+Time: %s, Memory: %s MB
+
+Error (ParaTest\Tests\fixtures\common_results\Error)
+ ✘ Error
+   │
+   │ RuntimeException: Error here!
+   │
+   │ %s/test/fixtures/common_results/ErrorTest.php:15
+   │
+
+Failure (ParaTest\Tests\fixtures\common_results\Failure)
+ ✘ Failure
+   │
+   │ Failed asserting that false is true.
+   │
+   │ %s/test/fixtures/common_results/FailureTest.php:14
+   │
+
+Incomplete (ParaTest\Tests\fixtures\common_results\Incomplete)
+ ∅ Incomplete
+   │
+   │
+   │ %s/test/fixtures/common_results/IncompleteTest.php:14
+   │
+
+Risky (ParaTest\Tests\fixtures\common_results\Risky)
+ ⚠ Risky
+
+Skipped (ParaTest\Tests\fixtures\common_results\Skipped)
+ ↩ Skipped
+
+Success (ParaTest\Tests\fixtures\common_results\Success)
+ ✔ Success
+
+Warning (ParaTest\Tests\fixtures\common_results\Warning)
+ ⚠ Warning
+
+Summary of tests with errors, failures, or issues:
+
+Error (ParaTest\Tests\fixtures\common_results\Error)
+ ✘ Error
+   │
+   │ RuntimeException: Error here!
+   │
+   │ %s/test/fixtures/common_results/ErrorTest.php:15
+   │
+
+Failure (ParaTest\Tests\fixtures\common_results\Failure)
+ ✘ Failure
+   │
+   │ Failed asserting that false is true.
+   │
+   │ %s/test/fixtures/common_results/FailureTest.php:14
+   │
+
+Incomplete (ParaTest\Tests\fixtures\common_results\Incomplete)
+ ∅ Incomplete
+   │
+   │
+   │ %s/test/fixtures/common_results/IncompleteTest.php:14
+   │
+
+Risky (ParaTest\Tests\fixtures\common_results\Risky)
+ ⚠ Risky
+
+Skipped (ParaTest\Tests\fixtures\common_results\Skipped)
+ ↩ Skipped
+
+Warning (ParaTest\Tests\fixtures\common_results\Warning)
+ ⚠ Warning
+
+ERRORS!
+Tests: %s