Add exclude paths option

Author: WalterWoshid

src/CodeTransformerKernel.php

@@ -73,6 +73,13 @@ public function __construct() {}
      */
     protected ?string $cacheDir = null;
 
+    /**
+     * The exclude paths. Paths/directories in this array will be excluded
+     *
+     * @var array
+     */
+    protected array $excludePaths = [];
+
     /**
      * The cache file mode.
      * <br><b>Default:</b> 0777 & ~{@link umask()}<br>
@@ -187,6 +194,7 @@ protected function preInit(): void
             cacheFileMode: $this->cacheFileMode,
             debug:         $this->debug,
             environment:   $this->environment,
+            excludePaths:  $this->excludePaths,
         );
 
         // Add the transformers

src/Core/AutoloadInterceptor/ClassLoader.php

@@ -107,6 +107,11 @@ public function findFile($namespacedClass): false|string
 
         $filePath = Path::resolve($filePath);
 
+        foreach ($this->options->getExcludePaths() as $path) {
+            if (str_starts_with($filePath, Path::resolve($path))) {
+                return $filePath;
+            }
+        }
 
         // Query cache state
         $cacheState = $this->cacheStateManager->queryCacheState($filePath);

src/Core/Options.php

@@ -32,6 +32,13 @@ class Options implements ServiceInterface
      */
     private string $cacheDir;
 
+    /**
+     * The exclude paths.
+     *
+     * @var array
+     */
+    private array $excludePaths;
+
     /**
      * The cache file mode.
      *
@@ -79,6 +86,7 @@ public function setOptions(
         ?int        $cacheFileMode,
         bool        $debug,
         Environment $environment,
+        array       $excludePaths = [],
     ): void {
         $composerRef = new ReflectionClass(ClassLoader::class);
         $composerDir = $composerRef->getFileName();
@@ -89,6 +97,7 @@ public function setOptions(
         $this->cacheFileMode = $cacheFileMode ?? (0777 & ~umask());
         $this->debug         = $debug;
         $this->environment   = $environment;
+        $this->excludePaths  = $excludePaths;
     }
 
     // endregion
@@ -121,6 +130,14 @@ public function getCacheDir(): string
         return $this->cacheDir;
     }
 
+    /**
+     * Get the exclude paths.
+     */
+    public function getExcludePaths(): array
+    {
+        return $this->excludePaths;
+    }
+
     /**
      * Get the cache file mode.
      */

tests/Functional/Transformer/SyntaxErrorInTransformedClass/Transformer.php

@@ -19,7 +19,7 @@ public function transform(Code $code): void
         $refClass = $code->getReflectionClass();
         assert($refClass->getName() === Target::class);
 
-        $className = $code->getClassName();
+        $className = $code->getNewSource();
         assert($className === 'SyntaxErrorClass');
     }
 }