fix: normalize snapshot paths for tests outside the main tests directory

phpunit.xml

@@ -16,6 +16,7 @@
   <testsuites>
     <testsuite name="default">
       <directory suffix=".php">./tests</directory>
+      <directory suffix=".php">./tests-external</directory>
       <exclude>./tests/.snapshots</exclude>
       <exclude>./tests/.tests</exclude>
       <exclude>./tests/Fixtures/Inheritance</exclude>

src/Repositories/SnapshotRepository.php

@@ -19,6 +19,7 @@ final class SnapshotRepository
      * Creates a snapshot repository instance.
      */
     public function __construct(
+        readonly private string $rootPath,
         readonly private string $testsPath,
         readonly private string $snapshotsPath,
     ) {}
@@ -103,7 +104,19 @@ public function flush(): void
      */
     private function getSnapshotFilename(): string
     {
-        $relativePath = str_replace($this->testsPath, '', TestSuite::getInstance()->getFilename());
+        $testFile = TestSuite::getInstance()->getFilename();
+
+        if (str_starts_with($testFile, $this->testsPath)) {
+            // if the test file is in the tests directory
+            $startPath = $this->testsPath;
+        } else {
+            // if the test file is in the app, src, etc. directory
+            $startPath = $this->rootPath;
+        }
+
+        // relative path: we use substr() and not str_replace() to remove the start path
+        // for instance, if the $startPath is /app/ and the $testFile is /app/app/tests/Unit/ExampleTest.php, we should only remove the first /app/ from the path
+        $relativePath = substr($testFile, strlen($startPath));
 
         // remove extension from filename
         $relativePath = substr($relativePath, 0, (int) strrpos($relativePath, '.'));

src/TestSuite.php

@@ -78,6 +78,7 @@ public function __construct(
         $this->afterAll = new AfterAllRepository;
         $this->rootPath = (string) realpath($rootPath);
         $this->snapshots = new SnapshotRepository(
+            $this->rootPath,
             implode(DIRECTORY_SEPARATOR, [$this->rootPath, $this->testPath]),
             implode(DIRECTORY_SEPARATOR, ['.pest', 'snapshots']),
         );

tests-external/Features/Expect/toMatchSnapshot.php

@@ -0,0 +1,35 @@
+<?php
+
+use Pest\TestSuite;
+
+beforeEach(function () {
+    $this->snapshotable = <<<'HTML'
+        <div class="container">
+            <div class="row">
+                <div class="col-md-12">
+                    <h1>Snapshot</h1>
+                </div>
+            </div>
+        </div>
+    HTML;
+});
+
+test('pass with dataset', function ($data) {
+    TestSuite::getInstance()->snapshots->save($this->snapshotable);
+    [$filename] = TestSuite::getInstance()->snapshots->get();
+
+    expect($filename)->toStartWith('tests/.pest/snapshots-external/')
+        ->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
+        ->and($this->snapshotable)->toMatchSnapshot();
+})->with(['my-datas-set-value']);
+
+describe('within describe', function () {
+    test('pass with dataset', function ($data) {
+        TestSuite::getInstance()->snapshots->save($this->snapshotable);
+        [$filename] = TestSuite::getInstance()->snapshots->get();
+
+        expect($filename)->toStartWith('tests/.pest/snapshots-external/')
+            ->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
+            ->and($this->snapshotable)->toMatchSnapshot();
+    });
+})->with(['my-datas-set-value']);

tests/.pest/snapshots-external/Features/Expect/toMatchSnapshot/_within_describe__→_pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap

@@ -0,0 +1,7 @@
+    <div class="container">
+        <div class="row">
+            <div class="col-md-12">
+                <h1>Snapshot</h1>
+            </div>
+        </div>
+    </div>

tests/.pest/snapshots-external/Features/Expect/toMatchSnapshot/pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap

@@ -0,0 +1,7 @@
+    <div class="container">
+        <div class="row">
+            <div class="col-md-12">
+                <h1>Snapshot</h1>
+            </div>
+        </div>
+    </div>

tests/Features/Expect/toMatchSnapshot.php

@@ -74,7 +74,8 @@ public function toString()
     TestSuite::getInstance()->snapshots->save($this->snapshotable);
     [$filename] = TestSuite::getInstance()->snapshots->get();
 
-    expect($filename)->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
+    expect($filename)->toStartWith('tests/.pest/snapshots/')
+        ->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
         ->and($this->snapshotable)->toMatchSnapshot();
 })->with(['my-datas-set-value']);
 
@@ -83,7 +84,8 @@ public function toString()
         TestSuite::getInstance()->snapshots->save($this->snapshotable);
         [$filename] = TestSuite::getInstance()->snapshots->get();
 
-        expect($filename)->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
+        expect($filename)->toStartWith('tests/.pest/snapshots/')
+            ->toEndWith('pass_with_dataset_with_data_set____my_datas_set_value______my_datas_set_value__.snap')
             ->and($this->snapshotable)->toMatchSnapshot();
     });
 })->with(['my-datas-set-value']);