release: v3.1.0

Fix #1265 -  issue parameter cannot be int (one done, pr, todo, wip)

.github/workflows/tests.yml

@@ -13,8 +13,8 @@ jobs:
       fail-fast: true
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        symfony: ['7.0']
-        php: ['8.2', '8.3']
+        symfony: ['7.1']
+        php: ['8.2', '8.3', '8.4']
         dependency_version: [prefer-lowest, prefer-stable]
 
     name: PHP ${{ matrix.php }} - Symfony ^${{ matrix.symfony }} - ${{ matrix.os }} - ${{ matrix.dependency_version }}
@@ -36,7 +36,13 @@ jobs:
         echo "::add-matcher::${{ runner.tool_cache }}/phpunit.json"
 
     - name: Install PHP dependencies
-      run: composer update --${{ matrix.dependency_version }} --no-interaction --no-progress --ansi --with="symfony/console:~${{ matrix.symfony }}"
+      shell: bash
+      run: |
+        if [[ "${{ matrix.php }}" == "8.4" ]]; then
+          composer update --${{ matrix.dependency_version }} --no-interaction --no-progress --ansi --with="symfony/console:^${{ matrix.symfony }}" --ignore-platform-req=php
+        else
+          composer update --${{ matrix.dependency_version }} --no-interaction --no-progress --ansi --with="symfony/console:^${{ matrix.symfony }}"
+        fi
 
     - name: Unit Tests
       run: composer test:unit
@@ -45,4 +51,5 @@ jobs:
       run: composer test:parallel
 
     - name: Integration Tests
+      if: ${{ matrix.php != '8.4' }}
       run: composer test:integration

composer.json

@@ -23,7 +23,7 @@
         "nunomaduro/termwind": "^2.1.0",
         "pestphp/pest-plugin": "^3.0.0",
         "pestphp/pest-plugin-arch": "^3.0.0",
-        "pestphp/pest-plugin-mutate": "^3.0.3",
+        "pestphp/pest-plugin-mutate": "^3.0.4",
         "phpunit/phpunit": "^11.3.6"
     },
     "conflict": {

src/Functions.php

@@ -217,7 +217,7 @@ if (! function_exists('afterAll')) {
 
 if (! function_exists('covers')) {
     /**
-     * Specifies which classes, or functions, a test method covers.
+     * Specifies which classes, or functions, a test case covers.
      *
      * @param  array<int, string>|string  $classesOrFunctions
      */
@@ -243,3 +243,38 @@ if (! function_exists('covers')) {
         }
     }
 }
+
+if (! function_exists('mutates')) {
+    /**
+     * Specifies which classes, enums, or traits a test case mutates.
+     *
+     * @param  array<int, string>|string  $targets
+     */
+    function mutates(array|string ...$targets): void
+    {
+        $filename = Backtrace::file();
+
+        $beforeEachCall = (new BeforeEachCall(TestSuite::getInstance(), $filename));
+        $beforeEachCall->group('__pest_mutate_only');
+
+        /** @var MutationTestRunner $runner */
+        $runner = Container::getInstance()->get(MutationTestRunner::class);
+        /** @var \Pest\Mutate\Repositories\ConfigurationRepository $configurationRepository */
+        $configurationRepository = Container::getInstance()->get(ConfigurationRepository::class);
+        $everything = $configurationRepository->cliConfiguration->toArray()['everything'] ?? false;
+        $classes = $configurationRepository->cliConfiguration->toArray()['classes'] ?? false;
+        $paths = $configurationRepository->cliConfiguration->toArray()['paths'] ?? false;
+
+        if ($runner->isEnabled() && ! $everything && ! is_array($classes) && ! is_array($paths)) {
+            $beforeEachCall->only('__pest_mutate_only');
+        }
+
+        /** @var ConfigurationRepository $configurationRepository */
+        $configurationRepository = Container::getInstance()->get(ConfigurationRepository::class);
+        $paths = $configurationRepository->cliConfiguration->toArray()['paths'] ?? false;
+
+        if (! is_array($paths)) {
+            $configurationRepository->globalConfiguration('default')->class(...$targets); // @phpstan-ignore-line
+        }
+    }
+}

src/PendingCalls/TestCall.php

@@ -358,8 +358,8 @@ final class TestCall
     public function todo(// @phpstan-ignore-line
         array|string|null $note = null,
         array|string|null $assignee = null,
-        array|string|null $issue = null,
-        array|string|null $pr = null,
+        array|string|int|null $issue = null,
+        array|string|int|null $pr = null,
     ): self {
         $this->skip('__TODO__');
 
@@ -390,8 +390,8 @@ final class TestCall
     public function wip(// @phpstan-ignore-line
         array|string|null $note = null,
         array|string|null $assignee = null,
-        array|string|null $issue = null,
-        array|string|null $pr = null,
+        array|string|int|null $issue = null,
+        array|string|int|null $pr = null,
     ): self {
         if ($issue !== null) {
             $this->issue($issue);
@@ -418,8 +418,8 @@ final class TestCall
     public function done(// @phpstan-ignore-line
         array|string|null $note = null,
         array|string|null $assignee = null,
-        array|string|null $issue = null,
-        array|string|null $pr = null,
+        array|string|int|null $issue = null,
+        array|string|int|null $pr = null,
     ): self {
         if ($issue !== null) {
             $this->issue($issue);

src/Pest.php

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

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

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

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

@@ -1,3 +1,3 @@
 
-  Pest Testing Framework 3.0.7.  
+  Pest Testing Framework 3.1.0.