Update File Feautre

Author: jihoonahn

Sources/File/Child.swift

@@ -1,4 +1,7 @@
 import Foundation
+import Logging
+
+private let logger = Logger(label: "Child")
 
 // MARK: - Child
 public extension Folder {

Sources/File/File.swift

@@ -1,4 +1,7 @@
 import Foundation
+import Logging
+
+private let logger = Logger(label: "File")
 
 /// File functionality in PLFile
 public struct File: FileSystem {
@@ -66,6 +69,14 @@ public extension File {
     }
 }
 
+// MARK: - Existence
+public extension File {
+    /// Checks if the file actually exists in the file system.
+    func exists() -> Bool {
+        return FileManager.default.fileExists(atPath: store.path.rawValue)
+    }
+}
+
 #if canImport(AppKit) && !targetEnvironment(macCatalyst)
 import AppKit
 

Sources/File/FileError.swift

@@ -1,4 +1,7 @@
 import Foundation
+import Logging
+
+private let logger = Logger(label: "FileError")
 
 /// Error can be thrown by PLFile
 public enum FileError: Error {

Sources/File/FileSystem.swift

@@ -1,4 +1,7 @@
 import Foundation
+import Logging
+
+private let logger = Logger(label: "FileSystem")
 
 /// Can use the functions of the file system as a key feature of PLFile.
 public protocol FileSystem: Equatable, CustomStringConvertible {

Sources/File/Folder.swift

@@ -1,4 +1,7 @@
 import Foundation
+import Logging
+
+private let logger = Logger(label: "Folder")
 
 /// Folder functionality in PLFile
 public struct Folder: FileSystem {
@@ -78,3 +81,36 @@ extension Folder {
         try subfolders.delete()
     }
 }
+
+// MARK: - Existence
+public extension Folder {
+    /// Checks if the folder actually exists in the file system.
+    func exists() -> Bool {
+        var isDir: ObjCBool = false
+        let exists = FileManager.default.fileExists(atPath: store.path.rawValue, isDirectory: &isDir)
+        return exists && isDir.boolValue
+    }
+}
+
+// MARK: - All Files/Folders
+public extension Folder {
+    /// Returns all files in the folder (supports recursive search).
+    func allFiles(recursive: Bool = false) -> [File] {
+        var result: [File] = []
+        let sequence = recursive ? self.files.recursiveStatus : self.files
+        for file in sequence {
+            result.append(file)
+        }
+        return result
+    }
+
+    /// Returns all subfolders in the folder (supports recursive search).
+    func allFolders(recursive: Bool = false) -> [Folder] {
+        var result: [Folder] = []
+        let sequence = recursive ? self.subfolders.recursiveStatus : self.subfolders
+        for folder in sequence {
+            result.append(folder)
+        }
+        return result
+    }
+}

Sources/File/Path.swift

@@ -1,4 +1,6 @@
 import Foundation
+import Logging
+private let logger = Logger(label: "Path")
 
 /// Manage the path of the PLFile.
 public struct Path {

Sources/File/Store.swift

@@ -1,4 +1,6 @@
 import Foundation
+import Dispatch
+import Logging
 
 /// A common part of the File and Folder functionality that allows you to set up the required paths and FileManager that the file system should use.
 public final class Store<fileSystem: FileSystem> {
@@ -176,3 +178,81 @@ extension Store where fileSystem == Folder {
         return File(store: store)
     }
 }
+
+// MARK: - Permission
+public extension Store {
+    /// Returns the file or folder permissions as a POSIX mode_t (Int).
+    func getPermissions() -> Int? {
+        let attributes = try? fileManager.attributesOfItem(atPath: path.rawValue)
+        return attributes?[.posixPermissions] as? Int
+    }
+
+    /// Sets the file or folder permissions using a POSIX mode_t (Int).
+    func setPermissions(_ permissions: Int) throws {
+        do {
+            try fileManager.setAttributes([.posixPermissions: permissions], ofItemAtPath: path.rawValue)
+        } catch {
+            throw FileError.writeFailed(path: path, error: error)
+        }
+    }
+}
+
+// MARK: - Symbolic Link
+public extension Store {
+    /// Checks if the path is a symbolic link.
+    func isSymbolicLink() -> Bool {
+        let attributes = try? fileManager.attributesOfItem(atPath: path.rawValue)
+        let fileType = attributes?[.type] as? FileAttributeType
+        return fileType == .typeSymbolicLink
+    }
+
+    /// Creates a symbolic link at this path pointing to the destination path.
+    func createSymbolicLink(to destinationPath: Path) throws {
+        do {
+            try fileManager.createSymbolicLink(atPath: path.rawValue, withDestinationPath: destinationPath.rawValue)
+        } catch {
+            throw FileError.writeFailed(path: path, error: error)
+        }
+    }
+
+    /// Returns the destination path of the symbolic link, if this is a symbolic link.
+    func destinationOfSymbolicLink() -> Path? {
+        do {
+            let dest = try fileManager.destinationOfSymbolicLink(atPath: path.rawValue)
+            return Path(dest)
+        } catch {
+            return nil
+        }
+    }
+}
+
+// MARK: - File/Folder Change Watch
+public extension Store {
+    /// Starts watching for changes to the file or folder at this path.
+    /// - Parameters:
+    ///   - eventHandler: Called when a change is detected.
+    /// - Returns: A DispatchSourceFileSystemObject? (macOS, iOS), or nil if not supported. Uses swift-log for logging.
+    @discardableResult
+    func watch(eventHandler: @escaping () -> Void) -> Any? {
+#if os(macOS) || os(iOS)
+        let fd = open(path.rawValue, O_EVTONLY)
+        guard fd != -1 else { return nil }
+        let source = DispatchSource.makeFileSystemObjectSource(fileDescriptor: fd, eventMask: .all, queue: .main)
+        source.setEventHandler(handler: eventHandler)
+        source.setCancelHandler {
+            close(fd)
+        }
+        source.resume()
+        return source
+#elseif os(Linux)
+        // Linux: inotify-based implementation needed (not implemented here)
+        let logger = Logger(label: "Store.Watch")
+        logger.warning("Watch is not implemented for Linux in this version.")
+        return nil
+#else
+        let logger = Logger(label: "Store.Watch")
+        logger.warning("Watch is not supported on this platform.")
+        return nil
+#endif
+    }
+}