Allow excluding paths from the source directory

Author: wouterj

packages/guides/src/FileCollector.php

@@ -17,9 +17,14 @@
 use Flyfinder\Specification\AndSpecification;
 use Flyfinder\Specification\HasExtension;
 use Flyfinder\Specification\InPath;
+use Flyfinder\Specification\NotSpecification;
+use Flyfinder\Specification\SpecificationInterface;
 use InvalidArgumentException;
 use League\Flysystem\FilesystemInterface;
 
+use function array_map;
+use function array_reduce;
+use function array_shift;
 use function sprintf;
 use function strlen;
 use function substr;
@@ -36,14 +41,29 @@ final class FileCollector
      * This takes into account the presence of cached & fresh MetaEntry
      * objects, and avoids adding files to the parse queue that have
      * not changed and whose direct dependencies have not changed.
+     *
+     * @param string[] $excludedPaths
      */
-    public function collect(FilesystemInterface $filesystem, string $directory, string $extension): Files
+    public function collect(FilesystemInterface $filesystem, string $directory, string $extension, array $excludedPaths = []): Files
     {
         $directory = trim($directory, '/');
+        $specification = new AndSpecification(new InPath(new Path($directory)), new HasExtension([$extension]));
+        if ($excludedPaths) {
+            $excludedSpecifications = array_map(static fn (string $path) => new NotSpecification(new InPath(new Path($path))), $excludedPaths);
+            $excludedSpecification = array_shift($excludedSpecifications);
+
+            $specification = new AndSpecification(
+                $specification,
+                array_reduce(
+                    $excludedSpecifications,
+                    static fn (SpecificationInterface $carry, SpecificationInterface $spec) => new AndSpecification($carry, $spec),
+                    $excludedSpecification,
+                ),
+            );
+        }
+
         /** @var array<array<string>> $files */
-        $files = $filesystem->find(
-            new AndSpecification(new InPath(new Path($directory)), new HasExtension([$extension])),
-        );
+        $files = $filesystem->find($specification);
 
         // completely populate the splFileInfos property
         $this->fileInfos = [];

packages/guides/src/Handlers/ParseDirectoryCommand.php

@@ -18,11 +18,13 @@
 
 final class ParseDirectoryCommand
 {
+    /** @param string[] $excludedPaths */
     public function __construct(
         private readonly FilesystemInterface $origin,
         private readonly string $directory,
         private readonly string $inputFormat,
         private readonly ProjectNode $projectNode,
+        private readonly array $excludedPaths = [],
     ) {
     }
 
@@ -45,4 +47,10 @@ public function getProjectNode(): ProjectNode
     {
         return $this->projectNode;
     }
+
+    /** @return string[] */
+    public function getExcludedPaths(): array
+    {
+        return $this->excludedPaths;
+    }
 }

packages/guides/src/Handlers/ParseDirectoryHandler.php

@@ -56,7 +56,7 @@ public function handle(ParseDirectoryCommand $command): array
             $extension,
         );
 
-        $files = $this->fileCollector->collect($origin, $currentDirectory, $extension);
+        $files = $this->fileCollector->collect($origin, $currentDirectory, $extension, $command->getExcludedPaths());
 
         $postCollectFilesForParsingEvent = $this->eventDispatcher->dispatch(
             new PostCollectFilesForParsingEvent($command, $files),