release: v2.10.0

composer.json

@@ -51,7 +51,7 @@
     "require-dev": {
         "pestphp/pest-dev-tools": "^2.12.0",
         "pestphp/pest-plugin-type-coverage": "^2.0.0",
-        "symfony/process": "^6.3.0"
+        "symfony/process": "^6.3.2"
     },
     "minimum-stability": "dev",
     "prefer-stable": true,
@@ -103,6 +103,7 @@
                 "Pest\\Plugins\\Profile",
                 "Pest\\Plugins\\Retry",
                 "Pest\\Plugins\\Snapshot",
+                "Pest\\Plugins\\Verbose",
                 "Pest\\Plugins\\Version",
                 "Pest\\Plugins\\Parallel"
             ]

src/Concerns/Testable.php

@@ -187,7 +187,24 @@ trait Testable
 
         $method = TestSuite::getInstance()->tests->get(self::$__filename)->getMethod($this->name());
 
-        $this->__description = self::$__latestDescription = $this->dataName() ? $method->description.' with '.$this->dataName() : $method->description;
+        $description = $this->dataName() ? $method->description.' with '.$this->dataName() : $method->description;
+
+        if ($method->repetitions > 1) {
+            $matches = [];
+            preg_match('/\((.*?)\)/', $description, $matches);
+
+            if (count($matches) > 1) {
+                if (str_contains($description, 'with '.$matches[0].' /')) {
+                    $description = str_replace('with '.$matches[0].' /', '', $description);
+                } else {
+                    $description = str_replace('with '.$matches[0], '', $description);
+                }
+            }
+
+            $description .= ' @ repetition '.($matches[1].' of '.$method->repetitions);
+        }
+
+        $this->__description = self::$__latestDescription = $description;
 
         parent::setUp();
 
@@ -238,6 +255,12 @@ trait Testable
      */
     private function __resolveTestArguments(array $arguments): array
     {
+        $method = TestSuite::getInstance()->tests->get(self::$__filename)->getMethod($this->name());
+
+        if ($method->repetitions > 1) {
+            array_shift($arguments);
+        }
+
         $underlyingTest = Reflection::getFunctionVariable($this->__test, 'closure');
         $testParameterTypes = array_values(Reflection::getFunctionArguments($underlyingTest));
 

src/Exceptions/InvalidArgumentException.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Exceptions;
+
+use InvalidArgumentException as BaseInvalidArgumentException;
+use NunoMaduro\Collision\Contracts\RenderlessEditor;
+use NunoMaduro\Collision\Contracts\RenderlessTrace;
+use Symfony\Component\Console\Exception\ExceptionInterface;
+
+/**
+ * @internal
+ */
+final class InvalidArgumentException extends BaseInvalidArgumentException implements ExceptionInterface, RenderlessEditor, RenderlessTrace
+{
+    /**
+     * Creates a new Exception instance.
+     */
+    public function __construct(string $message)
+    {
+        parent::__construct($message, 1);
+    }
+}

src/Factories/TestCaseMethodFactory.php

@@ -26,6 +26,11 @@ final class TestCaseMethodFactory
      */
     public ?string $describing = null;
 
+    /**
+     * The test's number of repetitions.
+     */
+    public int $repetitions = 1;
+
     /**
      * Determines if the test is a "todo".
      */
@@ -140,7 +145,7 @@ final class TestCaseMethodFactory
             $attributes = (new $attribute())->__invoke($this, $attributes);
         }
 
-        if ($this->datasets !== []) {
+        if ($this->datasets !== [] || $this->repetitions > 1) {
             $dataProviderName = $methodName.'_dataset';
             $annotations[] = "@dataProvider $dataProviderName";
             $datasetsCode = $this->buildDatasetForEvaluation($methodName, $dataProviderName);
@@ -177,7 +182,13 @@ final class TestCaseMethodFactory
      */
     private function buildDatasetForEvaluation(string $methodName, string $dataProviderName): string
     {
-        DatasetsRepository::with($this->filename, $methodName, $this->datasets);
+        $datasets = $this->datasets;
+
+        if ($this->repetitions > 1) {
+            $datasets = [range(1, $this->repetitions), ...$datasets];
+        }
+
+        DatasetsRepository::with($this->filename, $methodName, $datasets);
 
         return <<<EOF
 

src/PendingCalls/TestCall.php

@@ -5,7 +5,7 @@ declare(strict_types=1);
 namespace Pest\PendingCalls;
 
 use Closure;
-use InvalidArgumentException;
+use Pest\Exceptions\InvalidArgumentException;
 use Pest\Factories\Covers\CoversClass;
 use Pest\Factories\Covers\CoversFunction;
 use Pest\Factories\Covers\CoversNothing;
@@ -214,6 +214,20 @@ final class TestCall
             : $this;
     }
 
+    /**
+     * Repeats the current test the given number of times.
+     */
+    public function repeat(int $times): self
+    {
+        if ($times < 1) {
+            throw new InvalidArgumentException('The number of repetitions must be greater than 0.');
+        }
+
+        $this->testCaseMethod->repetitions = $times;
+
+        return $this;
+    }
+
     /**
      * Sets the test as "todo".
      */

src/Pest.php

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

src/Plugins/Verbose.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Plugins;
+
+use Pest\Contracts\Plugins\HandlesArguments;
+
+/**
+ * @internal
+ */
+final class Verbose implements HandlesArguments
+{
+    use Concerns\HandleArguments;
+
+    /**
+     * The list of verbosity levels.
+     */
+    private const VERBOSITY_LEVELS = ['v', 'vv', 'vvv', 'q'];
+
+    /**
+     * {@inheritDoc}
+     */
+    public function handleArguments(array $arguments): array
+    {
+        foreach (self::VERBOSITY_LEVELS as $level) {
+            if ($this->hasArgument('-'.$level, $arguments)) {
+                $arguments = $this->popArgument('-'.$level, $arguments);
+            }
+        }
+
+        if ($this->hasArgument('--quiet', $arguments)) {
+            return $this->popArgument('--quiet', $arguments);
+        }
+
+        return $arguments;
+    }
+}

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

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

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

@@ -1,3 +1,3 @@
 
-  Pest Testing Framework 2.9.5.  
+  Pest Testing Framework 2.10.0.  
 

tests/.snapshots/success.txt

@@ -762,6 +762,95 @@
   ! notice → This is a notice description // tests/Features/Notices.php:4
   ! a "describe" group of tests → notice → This is a notice description // tests/Features/Notices.php:11
 
+   PASS  Tests\Features\Repeat
+  ✓ once
+  ✓ multiple times @ repetition 1 of 5
+  ✓ multiple times @ repetition 2 of 5
+  ✓ multiple times @ repetition 3 of 5
+  ✓ multiple times @ repetition 4 of 5
+  ✓ multiple times @ repetition 5 of 5
+  ✓ multiple times with single dataset dataset "a" @ repetition 1 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 1 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 1 of 6
+  ✓ multiple times with single dataset dataset "a" @ repetition 2 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 2 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 2 of 6
+  ✓ multiple times with single dataset dataset "a" @ repetition 3 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 3 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 3 of 6
+  ✓ multiple times with single dataset dataset "a" @ repetition 4 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 4 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 4 of 6
+  ✓ multiple times with single dataset dataset "a" @ repetition 5 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 5 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 5 of 6
+  ✓ multiple times with single dataset dataset "a" @ repetition 6 of 6
+  ✓ multiple times with single dataset dataset "b" @ repetition 6 of 6
+  ✓ multiple times with single dataset dataset "c" @ repetition 6 of 6
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 1 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 2 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 3 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 4 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 5 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 6 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (4) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (5) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "a" / (6) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (4) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (5) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "b" / (6) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (4) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (5) @ repetition 7 of 7
+  ✓ multiple times with multiple dataset dataset "c" / (6) @ repetition 7 of 7
+
    PASS  Tests\Features\ScopedDatasets\Directory\NestedDirectory1\TestFileInNestedDirectoryWithDatasetsFile
   ✓ uses dataset with (1)
   ✓ uses dataset with (2)
@@ -1085,4 +1174,4 @@
    WARN  Tests\Visual\Version
   - visual snapshot of help command output
 
-  Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 13 todos, 19 skipped, 743 passed (1777 assertions)
+  Tests:    2 deprecated, 4 warnings, 5 incomplete, 2 notices, 13 todos, 19 skipped, 830 passed (1927 assertions)

tests/Features/Repeat.php

@@ -0,0 +1,18 @@
+<?php
+
+test('once', function () {
+    expect(true)->toBeTrue();
+})->repeat(times: 1);
+
+test('multiple times', function () {
+    expect(true)->toBeTrue();
+})->repeat(times: 5);
+
+test('multiple times with single dataset', function (int $number) {
+    expect([1, 2, 3])->toContain($number);
+})->repeat(times: 6)->with(['a' => 1, 'b' => 2, 'c' => 3]);
+
+test('multiple times with multiple dataset', function (int $numberA, int $numberB) {
+    expect([1, 2, 3])->toContain($numberA)
+        ->and([4, 5, 6])->toContain($numberB);
+})->repeat(times: 7)->with(['a' => 1, 'b' => 2, 'c' => 3], [4, 5, 6]);

tests/Visual/Parallel.php

@@ -16,7 +16,7 @@ $run = function () {
 
 test('parallel', function () use ($run) {
     expect($run('--exclude-group=integration'))
-        ->toContain('Tests:    1 deprecated, 4 warnings, 5 incomplete, 2 notices, 13 todos, 15 skipped, 732 passed (1762 assertions)')
+        ->toContain('Tests:    1 deprecated, 4 warnings, 5 incomplete, 2 notices, 13 todos, 15 skipped, 819 passed (1912 assertions)')
         ->toContain('Parallel: 3 processes');
 })->skipOnWindows();