Template support for input parameters (#4)

This PR contains the work done to support input parameters for the `create` command of the executable target, and to render content dynamically for the newly-generated project.

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

Library/Sources/Public/Models/Project.swift

@@ -0,0 +1,13 @@
+public struct Project: Equatable, Sendable {
+    
+    // MARK: Properties
+    
+    let name: String
+    
+    // MARK: Initialisers
+    
+    public init(name: String) {
+        self.name = name
+    }
+    
+}

Library/Sources/Public/Protocols/Bundleable.swift

@@ -1,6 +1,10 @@
 import Foundation
 
 public protocol Bundleable {
+    
+    // MARK: Computed
+    
+    var resourcePath: String? { get }
 
     // MARK: Functions
     

Library/Sources/Public/Protocols/FileServicing.swift

@@ -9,6 +9,7 @@ public protocol FileServicing {
     // MARK: Functions
     
     func copyFile(from source: URL, to destination: URL) async throws (FileServiceError)
+    func createFile(at location: URL, with data: Data) async throws (FileServiceError)
     func createFolder(at location: URL) async throws (FileServiceError)
     func deleteItem(at location: URL) async throws (FileServiceError)
     func isItemExists(at location: URL) async throws (FileServiceError) -> Bool
@@ -18,6 +19,8 @@ public protocol FileServicing {
 // MARK: - Errors
 
 public enum FileServiceError: Error, Equatable {
+    case fileDataIsEmpty
+    case fileNotCreated
     case folderNotCreated
     case itemAlreadyExists
     case itemEmptyData

Library/Sources/Public/Protocols/TemplateServicing.swift

@@ -0,0 +1,16 @@
+public protocol TemplateServicing {
+    
+    // MARK: Functions
+    
+    func render(_ object: Any, on template: String) async throws (TemplateServiceError) -> String
+    
+}
+
+// MARK: - Errors
+
+public enum TemplateServiceError: Error {
+    case contentNotRendered
+    case resourcePathNotFound
+    case serviceNotInitialized
+    case templateNotFound
+}

Library/Sources/Public/Protocols/TerminalServicing.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+public protocol TerminalServicing {
+    
+    // MARK: Functions
+    
+    @discardableResult
+    func run(_ executableURL: URL, arguments: [String]) async throws (TerminalServiceError) -> String
+    
+}
+
+// MARK: - Errors
+
+public enum TerminalServiceError: Error, Equatable {
+    case captured(_ output: String)
+    case output(_ output: String)
+    case unexpected
+}
+

Library/Sources/Public/Services/FileService.swift

@@ -1,7 +1,7 @@
 import Foundation
 
-public struct FileService: FileServicing {
-
+public struct FileService {
+    
     // MARK: Properties
     
     private let fileManager: FileManager
@@ -12,6 +12,12 @@ public struct FileService: FileServicing {
         self.fileManager = fileManager
     }
     
+}
+
+// MARK: - FileServicing
+
+extension FileService: FileServicing {
+
     // MARK: Computed
     
     public var currentFolder: URL {
@@ -24,7 +30,7 @@ public struct FileService: FileServicing {
     
     public func copyFile(from source: URL, to destination: URL) async throws (FileServiceError) {
         guard try await !isItemExists(at: destination) else {
-            throw FileServiceError.itemAlreadyExists
+            throw .itemAlreadyExists
         }
         
         var itemData: Data?
@@ -32,43 +38,59 @@ public struct FileService: FileServicing {
         do {
             itemData = try Data(contentsOf: source)
         } catch {
-            throw FileServiceError.itemEmptyData
+            throw .itemEmptyData
         }
         
         do {
             try itemData?.write(to: destination, options: .atomic)
         } catch {
-            throw FileServiceError.itemNotCopied
+            throw .itemNotCopied
+        }
+    }
+    
+    public func createFile(at location: URL, with data: Data) async throws (FileServiceError) {
+        guard try await !isItemExists(at: location) else {
+            throw .itemAlreadyExists
+        }
+        
+        guard !data.isEmpty else {
+            throw .fileDataIsEmpty
+        }
+        
+        do {
+            try data.write(to: location, options: .atomic)
+        } catch {
+            throw .fileNotCreated
         }
     }
 
     public func createFolder(at location: URL) async throws (FileServiceError) {
         guard try await !isItemExists(at: location) else {
-            throw FileServiceError.itemAlreadyExists
+            throw .itemAlreadyExists
         }
         
         do {
             try fileManager.createDirectory(at: location, withIntermediateDirectories: true)
         } catch {
-            throw FileServiceError.folderNotCreated
+            throw .folderNotCreated
         }
     }
     
     public func deleteItem(at location: URL) async throws (FileServiceError) {
         guard try await isItemExists(at: location) else {
-            throw FileServiceError.itemNotExists
+            throw .itemNotExists
         }
         
         do {
             try fileManager.removeItem(at: location)
         } catch {
-            throw FileServiceError.itemNotDeleted
+            throw .itemNotDeleted
         }
     }
     
     public func isItemExists(at location: URL) async throws (FileServiceError) -> Bool {
         guard location.isFileURL else {
-            throw FileServiceError.itemNotFileURL
+            throw .itemNotFileURL
         }
         
         let filePath = location.pathString

Library/Sources/Public/Services/TemplateService.swift

@@ -0,0 +1,50 @@
+import Foundation
+import Mustache
+
+public struct TemplateService {
+    
+    // MARK: Properties
+    
+    private let mustacheRenderer: MustacheLibrary
+    
+    // MARK: Initialisers
+    
+    public init(
+        bundle: Bundleable? = nil,
+        templateFolder: String
+    ) async throws (TemplateServiceError) {
+        guard let pathResources = (bundle ?? Bundle.module).resourcePath else {
+            throw .resourcePathNotFound
+        }
+        
+        let pathTemplates = pathResources + "/" + templateFolder
+        
+        do {
+            self.mustacheRenderer = try await MustacheLibrary(directory: pathTemplates)
+        } catch {
+            throw .serviceNotInitialized
+        }
+    }
+    
+}
+
+// MARK: - TemplateServicing
+
+extension TemplateService: TemplateServicing {
+
+    // MARK: Functions
+    
+    public func render(_ object: Any, on template: String) async throws (TemplateServiceError) -> String {
+        guard mustacheRenderer.getTemplate(named: template) != nil else {
+            throw .templateNotFound
+        }
+        
+        guard let content = mustacheRenderer.render(object, withTemplate: template) else {
+            throw .contentNotRendered
+        }
+        
+        return content
+    }
+    
+}
+

Library/Sources/Public/Services/TerminalService.swift

@@ -0,0 +1,60 @@
+import Foundation
+
+public struct TerminalService {
+    
+    // MARK: Initialisers
+    
+    public init() {}
+    
+}
+
+// MARK: - TerminalServicing
+
+extension TerminalService: TerminalServicing {
+    
+    // MARK: Functions
+    
+    public func run(_ executableURL: URL, arguments: [String]) async throws (TerminalServiceError) -> String {
+        let process = Process()
+        let standardError = Pipe()
+        let standardOutput = Pipe()
+
+        process.executableURL = executableURL
+        process.arguments = arguments
+        process.standardError = standardError
+        process.standardOutput = standardOutput
+        
+        async let streamOutput = standardOutput.availableData.append()
+        async let streamError = standardError.availableData.append()
+        
+        do {
+            try process.run()
+            
+            let dataOutput = await streamOutput
+            let dataError = await streamError
+            
+            guard dataError.isEmpty else {
+                guard let errorOutput = String(data: dataError, encoding: .utf8) else {
+                    throw TerminalServiceError.unexpected
+                }
+                
+                throw TerminalServiceError.output(errorOutput)
+            }
+            
+            guard let output = String(data: dataOutput, encoding: .utf8) else {
+                throw TerminalServiceError.unexpected
+            }
+            
+            return await withCheckedContinuation { continuation in
+                process.terminationHandler = { _ in
+                    continuation.resume(returning: output)
+                }
+            }
+        } catch let error as TerminalServiceError {
+            throw error
+        } catch {
+            throw .captured(error.localizedDescription)
+        }
+    }
+    
+}

Library/Sources/Public/Tasks/InitGitInFolderTask.swift

@@ -1,24 +1,26 @@
 import Foundation
 
 public struct InitGitInFolderTask {
+    
+    // MARK: Properties
+    
+    private let terminalService: TerminalServicing
 
     // MARK: Initialisers
     
-    public init() {}
+    public init(terminalService: TerminalServicing) {
+        self.terminalService = terminalService
+    }
     
     // MARK: Functions
     
-    public func callAsFunction(at rootFolder: URL) async throws (RunProcessError) {
-        let pathCommand = "/usr/bin/git"
+    public func callAsFunction(at rootFolder: URL) async throws (TerminalServiceError) {
+        let executableURL = URL(at: "/usr/bin/git")
         let pathFolder = rootFolder.pathString
         
-        var gitInit = RunProcessTask(process: Process())
-        var gitAdd = RunProcessTask(process: Process())
-        var gitCommit = RunProcessTask(process: Process())
-        
-        try await gitInit(path: pathCommand, arguments: ["init", pathFolder])
-        try await gitAdd(path: pathCommand, arguments: ["-C", pathFolder, "add", "."])
-        try await gitCommit(path: pathCommand, arguments: ["-C", pathFolder, "commit", "-m", "Initial commit"])
+        try await terminalService.run(executableURL, arguments: ["init", pathFolder])
+        try await terminalService.run(executableURL, arguments: ["-C", pathFolder, "add", "."])
+        try await terminalService.run(executableURL, arguments: ["-C", pathFolder, "commit", "-m", "Initial commit"])
     }
     
 }

Library/Sources/Public/Tasks/RenderFilesTask.swift

@@ -0,0 +1,34 @@
+import Foundation
+
+public struct RenderFilesTask {
+    
+    // MARK: Computed
+    
+    private let fileService: FileServicing
+    private let templateService: TemplateServicing
+
+    // MARK: Initialisers
+
+    public init(
+        fileService: FileServicing,
+        templateService: TemplateServicing
+    ) {
+        self.fileService = fileService
+        self.templateService = templateService
+    }
+    
+    // MARK: Functions
+    
+    public func callAsFunction(
+        at rootFolder: URL,
+        with model: Project
+    ) async throws {
+        for template in Template.allCases {
+            let content = try await templateService.render(model, on: template.rawValue)
+            let fileURL = rootFolder.appendingPath(template.filePath)
+
+            try await fileService.createFile(at: fileURL, with: Data(content.utf8))
+        }
+    }
+    
+}