release: 3.7.1

bin/worker.php

@@ -32,10 +32,13 @@ $bootPest = (static function (): void {
         'status-file:',
         'progress-file:',
         'unexpected-output-file:',
-        'testresult-file:',
+        'test-result-file:',
+        'result-cache-file:',
         'teamcity-file:',
         'testdox-file:',
         'testdox-color',
+        'testdox-columns:',
+        'testdox-summary',
         'phpunit-argv:',
     ]);
 
@@ -61,7 +64,8 @@ $bootPest = (static function (): void {
 
     assert(isset($getopt['progress-file']) && is_string($getopt['progress-file']));
     assert(isset($getopt['unexpected-output-file']) && is_string($getopt['unexpected-output-file']));
-    assert(isset($getopt['testresult-file']) && is_string($getopt['testresult-file']));
+    assert(isset($getopt['test-result-file']) && is_string($getopt['test-result-file']));
+    assert(! isset($getopt['result-cache-file']) || is_string($getopt['result-cache-file']));
     assert(! isset($getopt['teamcity-file']) || is_string($getopt['teamcity-file']));
     assert(! isset($getopt['testdox-file']) || is_string($getopt['testdox-file']));
 
@@ -77,7 +81,8 @@ $bootPest = (static function (): void {
         $phpunitArgv,
         $getopt['progress-file'],
         $getopt['unexpected-output-file'],
-        $getopt['testresult-file'],
+        $getopt['test-result-file'],
+        $getopt['result-cache-file'] ?? null,
         $getopt['teamcity-file'] ?? null,
         $getopt['testdox-file'] ?? null,
         isset($getopt['testdox-color']),

composer.json

@@ -18,17 +18,17 @@
     ],
     "require": {
         "php": "^8.2.0",
-        "brianium/paratest": "^7.6.0",
+        "brianium/paratest": "^7.7.0",
         "nunomaduro/collision": "^8.5.0",
         "nunomaduro/termwind": "^2.3.0",
         "pestphp/pest-plugin": "^3.0.0",
         "pestphp/pest-plugin-arch": "^3.0.0",
         "pestphp/pest-plugin-mutate": "^3.0.5",
-        "phpunit/phpunit": "^11.4.4"
+        "phpunit/phpunit": "^11.5.1"
     },
     "conflict": {
         "filp/whoops": "<2.16.0",
-        "phpunit/phpunit": ">11.4.4",
+        "phpunit/phpunit": ">11.5.1",
         "sebastian/exporter": "<6.0.0",
         "webmozart/assert": "<1.11.0"
     },
@@ -55,7 +55,7 @@
     "require-dev": {
         "pestphp/pest-dev-tools": "^3.3.0",
         "pestphp/pest-plugin-type-coverage": "^3.2.0",
-        "symfony/process": "^7.1.8"
+        "symfony/process": "^7.2.0"
     },
     "minimum-stability": "dev",
     "prefer-stable": true,

overrides/Event/Value/ThrowableBuilder.php

@@ -68,7 +68,7 @@ final readonly class ThrowableBuilder
             $previous = self::from($previous);
         }
 
-        $trace = Filter::getFilteredStacktrace($t);
+        $trace = Filter::stackTraceFromThrowableAsString($t);
 
         if ($t instanceof RenderableOnCollisionEditor && $frame = $t->toCollisionEditor()) {
             $file = $frame->getFile();

src/Bootstrappers/BootOverrides.php

@@ -19,12 +19,12 @@ final class BootOverrides implements Bootstrapper
      */
     public const FILES = [
         '53c246e5f416a39817ac81124cdd64ea8403038d01d7a202e1ffa486fbdf3fa7' => 'Runner/Filter/NameFilterIterator.php',
-        'a4a43de01f641c6944ee83d963795a46d32b5206b5ab3bbc6cce76e67190acbf' => 'Runner/ResultCache/DefaultResultCache.php',
+        '77ffb7647b583bd82e37962c6fbdc4b04d3344d8a2c1ed103e625ed1ff7cb5c2' => 'Runner/ResultCache/DefaultResultCache.php',
         'd0e81317889ad88c707db4b08a94cadee4c9010d05ff0a759f04e71af5efed89' => 'Runner/TestSuiteLoader.php',
         '3bb609b0d3bf6dee8df8d6cd62a3c8ece823c4bb941eaaae39e3cb267171b9d2' => 'TextUI/Command/Commands/WarmCodeCoverageCacheCommand.php',
         '8abdad6413329c6fe0d7d44a8b9926e390af32c0b3123f3720bb9c5bbc6fbb7e' => 'TextUI/Output/Default/ProgressPrinter/Subscriber/TestSkippedSubscriber.php',
         'b4250fc3ffad5954624cb5e682fd940b874e8d3422fa1ee298bd7225e1aa5fc2' => 'TextUI/TestSuiteFilterProcessor.php',
-        '357d5cd7007f8559b26e1b8cdf43bb6fb15b51b79db981779da6f31b7ec39dad' => 'Event/Value/ThrowableBuilder.php',
+        '8cfcb4999af79463eca51a42058e502ea4ddc776cba5677bf2f8eb6093e21a5c' => 'Event/Value/ThrowableBuilder.php',
         'ede161507d4c9c27805f55a05a32c3bb528e53b6e1fc092bfafdb8207e0019e9' => 'Logging/JUnit/JunitXmlLogger.php',
     ];
 

src/PendingCalls/AfterEachCall.php

@@ -56,7 +56,7 @@ final class AfterEachCall
 
         $afterEachTestCase = ChainableClosure::boundWhen(
             fn (): bool => $describing === [] || in_array(Arr::last($describing), $this->__describing, true),
-            ChainableClosure::bound(fn () => $proxies->chain($this), $this->closure)->bindTo($this, self::class), // @phpstan-ignore-line
+            ChainableClosure::bound(fn () => $proxies->chain($this), $this->closure)->bindTo($this, self::class),
         )->bindTo($this, self::class);
 
         assert($afterEachTestCase instanceof Closure);

src/PendingCalls/BeforeEachCall.php

@@ -79,7 +79,7 @@ final class BeforeEachCall
 
         $beforeEachTestCase = ChainableClosure::boundWhen(
             fn (): bool => $describing === [] || in_array(Arr::last($describing), $this->__describing, true),
-            ChainableClosure::bound(fn () => $testCaseProxies->chain($this), $this->closure)->bindTo($this, self::class), // @phpstan-ignore-line
+            ChainableClosure::bound(fn () => $testCaseProxies->chain($this), $this->closure)->bindTo($this, self::class),
         )->bindTo($this, self::class);
 
         assert($beforeEachTestCase instanceof Closure);

src/Pest.php

@@ -6,7 +6,7 @@ namespace Pest;
 
 function version(): string
 {
-    return '3.5.2';
+    return '3.7.1';
 }
 
 function testDirectory(string $file = ''): string

src/Plugins/Coverage.php

@@ -27,6 +27,11 @@ final class Coverage implements AddsOutput, HandlesArguments
      */
     private const MIN_OPTION = 'min';
 
+    /**
+     * @var string
+     */
+    private const EXACTLY_OPTION = 'exactly';
+
     /**
      * Whether it should show the coverage or not.
      */
@@ -37,6 +42,11 @@ final class Coverage implements AddsOutput, HandlesArguments
      */
     public float $coverageMin = 0.0;
 
+    /**
+     * The exactly coverage.
+     */
+    public ?float $coverageExactly = null;
+
     /**
      * Creates a new Plugin instance.
      */
@@ -51,7 +61,7 @@ final class Coverage implements AddsOutput, HandlesArguments
     public function handleArguments(array $originals): array
     {
         $arguments = [...[''], ...array_values(array_filter($originals, function (string $original): bool {
-            foreach ([self::COVERAGE_OPTION, self::MIN_OPTION] as $option) {
+            foreach ([self::COVERAGE_OPTION, self::MIN_OPTION, self::EXACTLY_OPTION] as $option) {
                 if ($original === sprintf('--%s', $option)) {
                     return true;
                 }
@@ -73,6 +83,7 @@ final class Coverage implements AddsOutput, HandlesArguments
         $inputs = [];
         $inputs[] = new InputOption(self::COVERAGE_OPTION, null, InputOption::VALUE_NONE);
         $inputs[] = new InputOption(self::MIN_OPTION, null, InputOption::VALUE_REQUIRED);
+        $inputs[] = new InputOption(self::EXACTLY_OPTION, null, InputOption::VALUE_REQUIRED);
 
         $input = new ArgvInput($arguments, new InputDefinition($inputs));
         if ((bool) $input->getOption(self::COVERAGE_OPTION)) {
@@ -106,6 +117,13 @@ final class Coverage implements AddsOutput, HandlesArguments
             $this->coverageMin = (float) $minOption;
         }
 
+        if ($input->getOption(self::EXACTLY_OPTION) !== null) {
+            /** @var int|float $exactlyOption */
+            $exactlyOption = $input->getOption(self::EXACTLY_OPTION);
+
+            $this->coverageExactly = (float) $exactlyOption;
+        }
+
         return $originals;
     }
 
@@ -127,10 +145,22 @@ final class Coverage implements AddsOutput, HandlesArguments
             }
 
             $coverage = \Pest\Support\Coverage::report($this->output);
-
             $exitCode = (int) ($coverage < $this->coverageMin);
 
-            if ($exitCode === 1) {
+            if ($exitCode === 0 && $this->coverageExactly !== null) {
+                $comparableCoverage = $this->computeComparableCoverage($coverage);
+                $comparableCoverageExactly = $this->computeComparableCoverage($this->coverageExactly);
+
+                $exitCode = $comparableCoverage === $comparableCoverageExactly ? 0 : 1;
+
+                if ($exitCode === 1) {
+                    $this->output->writeln(sprintf(
+                        "\n  <fg=white;bg=red;options=bold> FAIL </> Code coverage not exactly <fg=white;options=bold> %s %%</>, currently <fg=red;options=bold> %s %%</>.",
+                        number_format($this->coverageExactly, 1),
+                        number_format(floor($coverage * 10) / 10, 1),
+                    ));
+                }
+            } elseif ($exitCode === 1) {
                 $this->output->writeln(sprintf(
                     "\n  <fg=white;bg=red;options=bold> FAIL </> Code coverage below expected <fg=white;options=bold> %s %%</>, currently <fg=red;options=bold> %s %%</>.",
                     number_format($this->coverageMin, 1),
@@ -143,4 +173,12 @@ final class Coverage implements AddsOutput, HandlesArguments
 
         return $exitCode;
     }
+
+    /**
+     * Computes the comparable coverage to a percentage with one decimal.
+     */
+    private function computeComparableCoverage(float $coverage): float
+    {
+        return floor($coverage * 10) / 10;
+    }
 }

src/Plugins/Parallel/Paratest/WrapperRunner.php

@@ -19,6 +19,7 @@ use Pest\TestSuite;
 use PHPUnit\Event\Facade as EventFacade;
 use PHPUnit\Event\TestRunner\WarningTriggered;
 use PHPUnit\Runner\CodeCoverage;
+use PHPUnit\Runner\ResultCache\DefaultResultCache;
 use PHPUnit\TestRunner\TestResult\Facade as TestResultFacade;
 use PHPUnit\TestRunner\TestResult\TestResult;
 use PHPUnit\TextUI\Configuration\CodeCoverageFilterRegistry;
@@ -79,7 +80,10 @@ final class WrapperRunner implements RunnerInterface
     private array $unexpectedOutputFiles = [];
 
     /** @var list<SplFileInfo> */
-    private array $testresultFiles = [];
+    private array $resultCacheFiles = [];
+
+    /** @var list<SplFileInfo> */
+    private array $testResultFiles = [];
 
     /** @var list<SplFileInfo> */
     private array $coverageFiles = [];
@@ -264,7 +268,8 @@ final class WrapperRunner implements RunnerInterface
         $this->batches[$token] = 0;
 
         $this->unexpectedOutputFiles[] = $worker->unexpectedOutputFile;
-        $this->testresultFiles[] = $worker->testresultFile;
+        $this->unexpectedOutputFiles[] = $worker->unexpectedOutputFile;
+        $this->testResultFiles[] = $worker->testResultFile;
 
         if (isset($worker->junitFile)) {
             $this->junitFiles[] = $worker->junitFile;
@@ -298,12 +303,12 @@ final class WrapperRunner implements RunnerInterface
 
     private function complete(TestResult $testResultSum): int
     {
-        foreach ($this->testresultFiles as $testresultFile) {
-            if (! $testresultFile->isFile()) {
+        foreach ($this->testResultFiles as $testResultFile) {
+            if (! $testResultFile->isFile()) {
                 continue;
             }
 
-            $contents = file_get_contents($testresultFile->getPathname());
+            $contents = file_get_contents($testResultFile->getPathname());
             assert($contents !== false);
             $testResult = unserialize($contents);
             assert($testResult instanceof TestResult);
@@ -360,9 +365,20 @@ final class WrapperRunner implements RunnerInterface
             $testResultSum->phpNotices(),
             $testResultSum->phpWarnings(),
             $testResultSum->numberOfIssuesIgnoredByBaseline(),
-
         );
 
+        if ($this->options->configuration->cacheResult()) {
+            $resultCacheSum = new DefaultResultCache($this->options->configuration->testResultCacheFile());
+            foreach ($this->resultCacheFiles as $resultCacheFile) {
+                $resultCache = new DefaultResultCache($resultCacheFile->getPathname());
+                $resultCache->load();
+
+                $resultCacheSum->mergeWith($resultCache);
+            }
+
+            $resultCacheSum->persist();
+        }
+
         $this->printer->printResults(
             $testResultSum,
             $this->teamcityFiles,
@@ -375,7 +391,7 @@ final class WrapperRunner implements RunnerInterface
         $exitcode = Result::exitCode($this->options->configuration, $testResultSum);
 
         $this->clearFiles($this->unexpectedOutputFiles);
-        $this->clearFiles($this->testresultFiles);
+        $this->clearFiles($this->testResultFiles);
         $this->clearFiles($this->coverageFiles);
         $this->clearFiles($this->junitFiles);
         $this->clearFiles($this->teamcityFiles);

tests/.pest/snapshots/Visual/Help/visual_snapshot_of_help_command_output.snap

@@ -1,5 +1,5 @@
 
-  Pest Testing Framework 3.5.2.  
+  Pest Testing Framework 3.7.1.  
 
   USAGE: pest <file> [options]  
 

tests/.pest/snapshots/Visual/Version/visual_snapshot_of_help_command_output.snap

@@ -1,3 +1,3 @@
 
-  Pest Testing Framework 3.5.2.  
+  Pest Testing Framework 3.7.1.  
 

tests/.snapshots/success.txt

@@ -1491,6 +1491,16 @@
    PASS  Tests\Playground
   ✓ basic
 
+   PASS  Tests\Plugins\Coverage
+  ✓ compute comparable coverage with (0, 0)
+  ✓ compute comparable coverage with (0.5, 0.5)
+  ✓ compute comparable coverage with (1.0, 1.0)
+  ✓ compute comparable coverage with (32.51, 32.5)
+  ✓ compute comparable coverage with (32.12312321312312, 32.1)
+  ✓ compute comparable coverage with (32.53333333333333, 32.5)
+  ✓ compute comparable coverage with (32.57777771232132, 32.5)
+  ✓ compute comparable coverage with (100.0, 100.0)
+
    PASS  Tests\Plugins\Traits
   ✓ it allows global uses
   ✓ it allows multiple global uses registered in the same path
@@ -1698,4 +1708,4 @@
    WARN  Tests\Visual\Version
   - visual snapshot of help command output
 
-  Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 38 todos, 33 skipped, 1144 passed (2736 assertions)
+  Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 38 todos, 33 skipped, 1152 passed (2744 assertions)

tests/Plugins/Coverage.php

@@ -0,0 +1,23 @@
+<?php
+
+use Pest\Plugins\Coverage;
+use Symfony\Component\Console\Output\NullOutput;
+
+test('compute comparable coverage', function (float $givenValue, float $expectedValue) {
+    $output = new NullOutput;
+
+    $plugin = new Coverage($output);
+
+    $comparableCoverage = (fn () => $this->computeComparableCoverage($givenValue))->call($plugin);
+
+    expect($comparableCoverage)->toBe($expectedValue);
+})->with([
+    [0, 0],
+    [0.5, 0.5],
+    [1.0, 1.0],
+    [32.51, 32.5],
+    [32.12312321312312, 32.1],
+    [32.53333333333333, 32.5],
+    [32.57777771232132, 32.5],
+    [100.0, 100.0],
+]);

tests/Visual/Parallel.php

@@ -16,7 +16,7 @@ $run = function () {
 
 test('parallel', function () use ($run) {
     expect($run('--exclude-group=integration'))
-        ->toContain('Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 38 todos, 24 skipped, 1134 passed (2712 assertions)')
+        ->toContain('Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 38 todos, 24 skipped, 1142 passed (2720 assertions)')
         ->toContain('Parallel: 3 processes');
 })->skipOnWindows();