Root folder creation (#2)

This PR contains the work done to create the root folder of a new project when executing the _colibri_ executable. In addition, some other work has been done:

* added the `ArgumentParser` package dependency to the package;
* implemented the `FileService` service in the _library_ target;
* implemented the `CreateRootFolderTask` task in the _library_ target;
* removed some unnecessary comments and boilerplate code;

Reviewed-on: #2
Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>

Sources/Library/Extensions/URL+Inits.swift

@@ -0,0 +1,15 @@
+import Foundation
+
+extension URL {
+    
+    // MARK: Initialisers
+    
+    init(at filePath: String) {
+        if #available(macOS 13.0, *) {
+            self = URL(filePath: filePath)
+        } else {
+            self = URL(fileURLWithPath: filePath)
+        }
+    }
+    
+}

Sources/Library/Protocols/FileServicing.swift

@@ -0,0 +1,25 @@
+import Foundation
+
+public protocol FileServicing {
+    
+    // MARK: Computed
+    
+    var currentFolder: URL { get async }
+    
+    // MARK: Functions
+    
+    func createFolder(at url: URL) async throws (FileServiceError)
+    func delete(at url: URL) async throws (FileServiceError)
+    func exists(at url: URL) async throws (FileServiceError) -> Bool
+    
+}
+
+// MARK: - Errors
+
+public enum FileServiceError: Error, Equatable {
+    case folderNotCreated
+    case urlAlreadyExists
+    case urlNotDeleted
+    case urlNotExists
+    case urlNotFileURL
+}

Sources/Library/Services/FileService.swift

@@ -0,0 +1,78 @@
+import Foundation
+
+public struct FileService: FileServicing {
+
+    // MARK: Properties
+    
+    private let fileManager: FileManager
+    
+    // MARK: Initialisers
+    
+    public init(fileManager: FileManager = .default) {
+        self.fileManager = fileManager
+    }
+    
+    // MARK: Computed
+    
+    public var currentFolder: URL {
+        get async {
+            .init(at: fileManager.currentDirectoryPath)
+        }
+    }
+    
+    // MARK: Functions
+
+    public func createFolder(at url: URL) async throws (FileServiceError) {
+        guard try await !exists(at: url) else {
+            throw FileServiceError.urlAlreadyExists
+        }
+        
+        do {
+            try fileManager.createDirectory(
+                at: url,
+                withIntermediateDirectories: true
+            )
+        } catch {
+            throw FileServiceError.folderNotCreated
+        }
+    }
+    
+    public func delete(at url: URL) async throws (FileServiceError) {
+        guard try await exists(at: url) else {
+            throw FileServiceError.urlNotExists
+        }
+        
+        do {
+            try fileManager.removeItem(at: url)
+        } catch {
+            throw FileServiceError.urlNotDeleted
+        }
+    }
+    
+    public func exists(at url: URL) async throws (FileServiceError) -> Bool {
+        guard url.isFileURL else {
+            throw FileServiceError.urlNotFileURL
+        }
+        
+        let filePath = getPath(for: url)
+        
+        return fileManager.fileExists(atPath: filePath)
+    }
+    
+}
+
+// MARK: - Helpers
+
+private extension FileService {
+    
+    // MARK: Functions
+    
+    func getPath(for url: URL) -> String {
+        if #available(macOS 13.0, *) {
+            return url.path()
+        } else {
+            return url.path
+        }
+    }
+    
+}

Sources/Library/Tasks/CreateRootFolderTask.swift

@@ -0,0 +1,48 @@
+import Foundation
+
+public struct CreateRootFolderTask {
+    
+    // MARK: Properties
+    
+    private let fileService: FileServicing
+    
+    // MARK: Initialisers
+    
+    public init(fileService: FileServicing) {
+        self.fileService = fileService
+    }
+    
+    // MARK: Functions
+    
+    public func callAsFunction(
+        name: String,
+        at location: URL? = nil
+    ) async throws -> URL {
+        guard !name.isEmpty else {
+            throw CreateRootFolderError.nameIsEmpty
+        }
+
+        let rootFolder = if let location {
+            location
+        } else {
+            await fileService.currentFolder
+        }
+        
+        let newFolder = if #available(macOS 13.0, *) {
+            rootFolder.appending(path: name)
+        } else {
+            rootFolder.appendingPathComponent(name)
+        }
+
+        try await fileService.createFolder(at: newFolder)
+        
+        return newFolder
+    }
+    
+}
+
+// MARK: - Errors
+
+public enum CreateRootFolderError: Error {
+    case nameIsEmpty
+}