feat: add listFilesRecursively method to File class and corresponding test case

Author: barbosa89

src/Facades/File.php

@@ -18,6 +18,7 @@
  * @method static int getCreationTime(string $path)
  * @method static int getModificationTime(string $path)
  * @method static array listFiles(string $path, bool $relativePath = false)
+ * @method static array listFilesRecursively(string $path, string|null $extension = null)
  * @method static void deleteFile(string $path)
  * @method static void deleteDirectory(string $path)
  *

src/Filesystem/File.php

@@ -77,6 +77,25 @@ public function listFiles(string $path, bool $relativePath = false): array
         }, $this->driver->listFiles($path));
     }
 
+    public function listFilesRecursively(string $path, string|null $extension = null): array
+    {
+        $paths = [];
+
+        foreach ($this->listFiles($path) as $file) {
+            if ($this->driver->isDirectory($file)) {
+                $paths = array_merge($paths, $this->listFilesRecursively($file, $extension));
+
+                continue;
+            }
+
+            if ($this->driver->isFile($file) && ($extension === null || str_ends_with($file, $extension))) {
+                $paths[] = $file;
+            }
+        }
+
+        return $paths;
+    }
+
     public function deleteFile(string $path): void
     {
         $this->driver->deleteFile($path);

tests/Unit/Filesystem/FileTest.php

@@ -100,3 +100,13 @@
         $path . DIRECTORY_SEPARATOR . 'FileTest.php',
     ]);
 });
+
+it('list files in a directory recursively', function () {
+    $path = __DIR__;
+
+    $file = new File();
+
+    expect($file->listFilesRecursively($path, 'php'))->toBe([
+        $path . DIRECTORY_SEPARATOR . 'FileTest.php',
+    ]);
+});