Refactor analyseFile to analyzeFiles accepting multiple files

- Rename analyseFile() to analyzeFiles()
- Change signature to accept array of files only
- Process errors per file with proper filtering
- Update all references in tests and documentation
- Add better error messages showing which file has mismatches

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: JanTvrdik

README.md

@@ -34,7 +34,7 @@ class YourRuleTest extends RuleTestCase
 
     public function testRule(): void
     {
-        $this->analyseFile(__DIR__ . '/Data/YourRule/code.php');
+        $this->analyzeFiles([__DIR__ . '/Data/YourRule/code.php']);
     }
 }
 ```
@@ -82,7 +82,7 @@ During development, automatically generate error comments:
 public function testRule(): void
 {
     // Set to true temporarily to generate error comments
-    $this->analyseFile(__DIR__ . '/Data/code.php', autofix: true);
+    $this->analyzeFiles([__DIR__ . '/Data/code.php'], autofix: true);
 }
 ```
 
@@ -110,13 +110,13 @@ class ComplexRuleTest extends RuleTestCase
 
     public function testDefault(): void
     {
-        $this->analyseFile(__DIR__ . '/Data/ComplexRule/default.php');
+        $this->analyzeFiles([__DIR__ . '/Data/ComplexRule/default.php']);
     }
 
     public function testStrict(): void
     {
         $this->strictMode = true;
-        $this->analyseFile(__DIR__ . '/Data/ComplexRule/strict.php');
+        $this->analyzeFiles([__DIR__ . '/Data/ComplexRule/strict.php']);
     }
 }
 ```
@@ -127,7 +127,7 @@ class ComplexRuleTest extends RuleTestCase
 public function testPhp82Features(): void
 {
     $this->phpVersion = $this->createPhpVersion(80_200);
-    $this->analyseFile(__DIR__ . '/Data/Rule/php82-features.php');
+    $this->analyzeFiles([__DIR__ . '/Data/Rule/php82-features.php']);
 }
 ```
 

src/RuleTestCase.php

@@ -6,6 +6,7 @@
 use PHPStan\Analyser\Error;
 use PHPStan\Rules\Rule;
 use PHPStan\Testing\RuleTestCase as OriginalRuleTestCase;
+use function array_filter;
 use function array_values;
 use function explode;
 use function file_get_contents;
@@ -15,6 +16,7 @@
 use function preg_match;
 use function preg_match_all;
 use function preg_replace;
+use function sort;
 use function sprintf;
 use function trim;
 use function uniqid;
@@ -26,22 +28,36 @@
 abstract class RuleTestCase extends OriginalRuleTestCase
 {
 
-    protected function analyseFile(string $file, bool $autofix = false): void
+    /**
+     * @param list<string> $files
+     */
+    protected function analyzeFiles(array $files, bool $autofix = false): void
     {
-        $analyserErrors = $this->gatherAnalyserErrors([$file]);
+        sort($files);
+
+        $analyserErrors = $this->gatherAnalyserErrors($files);
 
         if ($autofix) {
-            $this->autofix($file, $analyserErrors);
-            self::fail("File {$file} was autofixed. This setup should never remain in the codebase.");
+            foreach ($files as $file) {
+                $fileErrors = array_filter($analyserErrors, static fn(Error $error): bool => $error->getFile() === $file);
+                $this->autofix($file, array_values($fileErrors));
+            }
+
+            $filesStr = implode(', ', $files);
+            self::fail("Files {$filesStr} were autofixed. This setup should never remain in the codebase.");
         }
 
-        $actualErrors = $this->processActualErrors($analyserErrors);
-        $expectedErrors = $this->parseExpectedErrors($file);
+        foreach ($files as $file) {
+            $fileErrors = array_filter($analyserErrors, static fn(Error $error): bool => $error->getFile() === $file);
+            $actualErrors = $this->processActualErrors(array_values($fileErrors));
+            $expectedErrors = $this->parseExpectedErrors($file);
 
-        self::assertSame(
-            implode("\n", $expectedErrors) . "\n",
-            implode("\n", $actualErrors) . "\n",
-        );
+            self::assertSame(
+                implode("\n", $expectedErrors) . "\n",
+                implode("\n", $actualErrors) . "\n",
+                "Errors in file {$file} do not match",
+            );
+        }
     }
 
     /**

tests/RuleTestCaseTest.php

@@ -19,15 +19,15 @@ protected function getRule(): Rule
 
     public function testRule(): void
     {
-        $this->analyseFile(__DIR__ . '/Rule/Data/DisallowDivisionByLiteralZeroRule/code.php');
+        $this->analyzeFiles([__DIR__ . '/Rule/Data/DisallowDivisionByLiteralZeroRule/code.php']);
     }
 
     public function testMultipleErrorsOnSameLine(): void
     {
         // Create a dedicated test file for multiple errors demonstration
         $testFile = __DIR__ . '/Rule/Data/DisallowDivisionByLiteralZeroRule/multiple-errors.php';
 
-        $this->analyseFile($testFile);
+        $this->analyzeFiles([$testFile]);
     }
 
 }