[feat]: find files and folders

Author: DanielCech

Sources/ScriptToolkit/FileExtension.swift

@@ -141,4 +141,36 @@ public extension File {
         run(ScriptToolkit.pdfCropPath, "--margins", insets.left, insets.top, insets.right, insets.bottom, path, newName)
         return try File(path: newName)
     }
+
+    ////////////////////////////////////////////////////////////////////////////////
+    // MARK: - Find files
+
+    public func findFirstFile(name: String, root: Folder) -> File? {
+        for file in root.makeFileSequence(recursive: true) {
+            if file.name == name {
+                return file
+            }
+        }
+        return nil
+    }
+
+    public func findFiles(name: String, root: Folder) -> [File] {
+        var foundFiles = [File]()
+        for file in root.makeFileSequence(recursive: true) {
+            if file.name == name {
+                foundFiles.append(file)
+            }
+        }
+        return foundFiles
+    }
+
+    public func findFiles(regex: String, root: Folder) -> [File] {
+        var foundFiles = [File]()
+        for file in root.makeFileSequence(recursive: true) {
+            if !matches(for: regex, in: file.name).isEmpty {
+                foundFiles.append(file)
+            }
+        }
+        return foundFiles
+    }
 }

Sources/ScriptToolkit/FolderExtension.swift

@@ -174,5 +174,37 @@ public extension Folder {
             try delete()
         }
     }
+
+    ////////////////////////////////////////////////////////////////////////////////
+    // MARK: - Find folders
+
+    public func findFirstFolder(name: String, root: Folder) -> Folder? {
+        for folder in root.makeSubfolderSequence(recursive: true) {
+            if folder.name == name {
+                return folder
+            }
+        }
+        return nil
+    }
+
+    public func findFolders(name: String, root: Folder) -> [Folder] {
+        var foundFolders = [Folder]()
+        for folder in root.makeSubfolderSequence(recursive: true) {
+            if folder.name == name {
+                foundFolders.append(folder)
+            }
+        }
+        return foundFolders
+    }
+
+    public func findFolders(regex: String, root: Folder) -> [Folder] {
+        var foundFolders = [Folder]()
+        for folder in root.makeSubfolderSequence(recursive: true) {
+            if !matches(for: regex, in: folder.name).isEmpty {
+                foundFolders.append(folder)
+            }
+        }
+        return foundFolders
+    }
 }