feat: Moves logging setup and generate-json for the create command to cli-client module.

Sources/CliClient/CliClient+Commands.swift

@@ -23,81 +23,91 @@ public extension CliClient {
     try await runCommand(quiet: quiet, shell: shell, args)
   }
 
-  func runPlaybookCommand(_ options: PlaybookOptions) async throws {
-    @Dependency(\.configurationClient) var configurationClient
-    @Dependency(\.logger) var logger
+  func runPlaybookCommand(
+    _ options: PlaybookOptions,
+    logging loggingOptions: LoggingOptions
+  ) async throws {
+    try await withLogger(loggingOptions) {
+      @Dependency(\.configurationClient) var configurationClient
+      @Dependency(\.logger) var logger
 
-    let configuration = try await configurationClient.ensuredConfiguration(options.configuration)
-    logger.trace("Configuration: \(configuration)")
+      let configuration = try await configurationClient.ensuredConfiguration(options.configuration)
+      logger.trace("Configuration: \(configuration)")
 
-    let playbookDirectory = try configuration.ensuredPlaybookDirectory(options.playbookDirectory)
-    let playbookPath = "\(playbookDirectory)/\(Constants.playbookFileName)"
-    logger.trace("Playbook path: \(playbookPath)")
+      let playbookDirectory = try configuration.ensuredPlaybookDirectory(options.playbookDirectory)
+      let playbookPath = "\(playbookDirectory)/\(Constants.playbookFileName)"
+      logger.trace("Playbook path: \(playbookPath)")
 
-    let inventoryPath = ensuredInventoryPath(
-      options.inventoryFilePath,
-      configuration: configuration,
-      playbookDirectory: playbookDirectory
-    )
-    logger.trace("Inventory path: \(inventoryPath)")
+      let inventoryPath = ensuredInventoryPath(
+        options.inventoryFilePath,
+        configuration: configuration,
+        playbookDirectory: playbookDirectory
+      )
+      logger.trace("Inventory path: \(inventoryPath)")
 
-    var arguments = [
-      Constants.playbookCommand, playbookPath,
-      "--inventory", inventoryPath
-    ] + options.arguments
+      var arguments = [
+        Constants.playbookCommand, playbookPath,
+        "--inventory", inventoryPath
+      ] + options.arguments
 
-    if let defaultArgs = configuration.args {
-      arguments.append(contentsOf: defaultArgs)
+      if let defaultArgs = configuration.args {
+        arguments.append(contentsOf: defaultArgs)
+      }
+
+      if configuration.useVaultArgs, let vaultArgs = configuration.vault.args {
+        arguments.append(contentsOf: vaultArgs)
+      }
+
+      logger.trace("Running playbook command with arguments: \(arguments)")
+
+      try await runCommand(
+        quiet: options.quiet,
+        shell: options.shell.orDefault,
+        arguments
+      )
     }
-
-    if configuration.useVaultArgs, let vaultArgs = configuration.vault.args {
-      arguments.append(contentsOf: vaultArgs)
-    }
-
-    logger.trace("Running playbook command with arguments: \(arguments)")
-
-    try await runCommand(
-      quiet: options.quiet,
-      shell: options.shell.orDefault,
-      arguments
-    )
   }
 
-  func runVaultCommand(_ options: VaultOptions) async throws {
-    @Dependency(\.configurationClient) var configurationClient
-    @Dependency(\.fileClient) var fileClient
-    @Dependency(\.logger) var logger
+  func runVaultCommand(
+    _ options: VaultOptions,
+    logging loggingOptions: LoggingOptions
+  ) async throws {
+    try await withLogger(loggingOptions) {
+      @Dependency(\.configurationClient) var configurationClient
+      @Dependency(\.fileClient) var fileClient
+      @Dependency(\.logger) var logger
 
-    let configuration = try await configurationClient.ensuredConfiguration(options.configuration)
-    logger.trace("Configuration: \(configuration)")
+      let configuration = try await configurationClient.ensuredConfiguration(options.configuration)
+      logger.trace("Configuration: \(configuration)")
 
-    let vaultFilePath = try await fileClient.ensuredVaultFilePath(options.vaultFilePath)
-    logger.trace("Vault file: \(vaultFilePath)")
+      let vaultFilePath = try await fileClient.ensuredVaultFilePath(options.vaultFilePath)
+      logger.trace("Vault file: \(vaultFilePath)")
 
-    var arguments = [
-      Constants.vaultCommand
-    ] + options.arguments
+      var arguments = [
+        Constants.vaultCommand
+      ] + options.arguments
 
-    if let defaultArgs = configuration.vault.args {
-      arguments.append(contentsOf: defaultArgs)
+      if let defaultArgs = configuration.vault.args {
+        arguments.append(contentsOf: defaultArgs)
+      }
+
+      if arguments.contains("encrypt"),
+         !arguments.contains("--encrypt-vault-id"),
+         let id = configuration.vault.encryptId
+      {
+        arguments.append(contentsOf: ["--encrypt-vault-id", id])
+      }
+
+      arguments.append(vaultFilePath)
+
+      logger.trace("Running vault command with arguments: \(arguments)")
+
+      try await runCommand(
+        quiet: options.quiet,
+        shell: options.shell.orDefault,
+        arguments
+      )
     }
-
-    if arguments.contains("encrypt"),
-       !arguments.contains("--encrypt-vault-id"),
-       let id = configuration.vault.encryptId
-    {
-      arguments.append(contentsOf: ["--encrypt-vault-id", id])
-    }
-
-    arguments.append(vaultFilePath)
-
-    logger.trace("Running vault command with arguments: \(arguments)")
-
-    try await runCommand(
-      quiet: options.quiet,
-      shell: options.shell.orDefault,
-      arguments
-    )
   }
 }
 
@@ -162,9 +172,4 @@ public extension FileClient {
   }
 }
 
-enum CliClientError: Error {
-  case playbookDirectoryNotFound
-  case vaultFileNotFound
-}
-
 extension ShellCommand.Shell: @retroactive @unchecked Sendable {}

Sources/CliClient/CliClientError.swift

@@ -0,0 +1,9 @@
+import Foundation
+
+public enum CliClientError: Error {
+  case encodingError
+  case playbookDirectoryNotFound
+  case templateDirectoryNotFound
+  case templateDirectoryOrRepoNotSpecified
+  case vaultFileNotFound
+}

Sources/CliClient/GenerateJson.swift

@@ -0,0 +1,80 @@
+import ConfigurationClient
+import Dependencies
+import Foundation
+
+// NOTE: We're not using the `Coders` client because we generally do not
+//       want the output to be `prettyPrinted` or anything, unless we're running
+//       tests, so we use a supplied json encoder.
+
+func createJSONData(
+  _ options: CliClient.GenerateJsonOptions,
+  logging loggingOptions: CliClient.LoggingOptions,
+  encoder: JSONEncoder = .init()
+) async throws -> Data {
+  try await CliClient.withLogger(loggingOptions) {
+    @Dependency(\.logger) var logger
+    @Dependency(\.configurationClient) var configurationClient
+
+    let configuration = try await configurationClient.findAndLoad()
+
+    let templateDir = options.templateDirectory ?? configuration.template.directory
+    let templateRepo = options.templateRepo ?? configuration.template.url
+    let version = options.version ?? configuration.template.version
+
+    logger.debug("""
+      (\(options.useLocalTemplateDirectory), \(String(describing: templateDir)), \(String(describing: templateRepo)))
+    """)
+
+    switch (options.useLocalTemplateDirectory, templateDir, templateRepo) {
+    case (true, .none, _):
+      // User supplied they wanted to use a local template directory, but we could not find
+      // the path set from command line or in configuration.
+      throw CliClientError.templateDirectoryNotFound
+    case let (false, _, .some(repo)):
+      // User did not supply they wanted to use a local template directory, and we found a repo url that was
+      // either set by the command line or found in the configuration.
+      logger.debug("Using repo.")
+      return try encoder.encode(TemplateRepo(repo: repo, version: version))
+    case let (true, .some(templateDir), _):
+      // User supplied they wanted to use a local template directory, and we found the template directory
+      // either set by the command line or in the configuration.
+      logger.debug("Using template directory.")
+      return try encoder.encode(TemplateDirJson(path: templateDir))
+    case let (false, .some(templateDir), _):
+      // User supplied they did not wanted to use a local template directory, and we found the template directory
+      // either set by the command line or in the configuration, and no repo was found / handled previously.
+      logger.debug("Using template directory.")
+      return try encoder.encode(TemplateDirJson(path: templateDir))
+    case (_, .none, .none):
+      // We could not find a repo or template directory.
+      throw CliClientError.templateDirectoryOrRepoNotSpecified
+    }
+  }
+}
+
+private struct TemplateDirJson: Encodable {
+
+  let template: Template
+
+  init(path: String) {
+    self.template = .init(path: path)
+  }
+
+  struct Template: Encodable {
+    let path: String
+  }
+}
+
+private struct TemplateRepo: Encodable {
+
+  let template: Template
+
+  init(repo: String, version: String?) {
+    self.template = .init(repo: repo, version: version ?? "main")
+  }
+
+  struct Template: Encodable {
+    let repo: String
+    let version: String
+  }
+}

Sources/CliClient/Interface.swift

@@ -4,9 +4,6 @@ import DependenciesMacros
 import Foundation
 import ShellClient
 
-// TODO: Add logging options and setup in this module and remove from the
-//       executable `hpa` module.
-
 public extension DependencyValues {
   var cliClient: CliClient {
     get { self[CliClient.self] }
@@ -16,11 +13,49 @@ public extension DependencyValues {
 
 @DependencyClient
 public struct CliClient: Sendable {
-
   public var runCommand: @Sendable (RunCommandOptions) async throws -> Void
+  public var generateJSON: @Sendable (GenerateJsonOptions, LoggingOptions, JSONEncoder) async throws -> String
+
+  public func generateJSON(
+    _ options: GenerateJsonOptions,
+    logging loggingOptions: LoggingOptions,
+    encoder jsonEncoder: JSONEncoder = .init()
+  ) async throws -> String {
+    try await generateJSON(options, loggingOptions, jsonEncoder)
+  }
 }
 
 public extension CliClient {
+
+  struct GenerateJsonOptions: Equatable, Sendable {
+    let templateDirectory: String?
+    let templateRepo: String?
+    let version: String?
+    let useLocalTemplateDirectory: Bool
+
+    public init(
+      templateDirectory: String?,
+      templateRepo: String?,
+      version: String?,
+      useLocalTemplateDirectory: Bool
+    ) {
+      self.templateDirectory = templateDirectory
+      self.templateRepo = templateRepo
+      self.version = version
+      self.useLocalTemplateDirectory = useLocalTemplateDirectory
+    }
+  }
+
+  struct LoggingOptions: Equatable, Sendable {
+    let commandName: String
+    let logLevel: Logger.Level
+
+    public init(commandName: String, logLevel: Logger.Level) {
+      self.commandName = commandName
+      self.logLevel = logLevel
+    }
+  }
+
   struct PlaybookOptions: Sendable, Equatable {
     let arguments: [String]
     let configuration: Configuration?
@@ -109,6 +144,12 @@ extension CliClient: DependencyKey {
           options.arguments
         ))
       }
+    } generateJSON: { options, loggingOptions, encoder in
+      let data = try await createJSONData(options, logging: loggingOptions, encoder: encoder)
+      guard let string = String(data: data, encoding: .utf8) else {
+        throw CliClientError.encodingError
+      }
+      return string
     }
   }
 
@@ -121,6 +162,8 @@ extension CliClient: DependencyKey {
   public static func capturing(_ client: CapturingClient) -> Self {
     .init { options in
       await client.set(options)
+    } generateJSON: {
+      try await Self().generateJSON($0, $1, $2)
     }
   }
 

Sources/CliClient/LoggingExtensions.swift

@@ -0,0 +1,28 @@
+import Dependencies
+import Logging
+import ShellClient
+
+public extension CliClient {
+
+  @discardableResult
+  func withLogger<T>(
+    _ options: LoggingOptions,
+    operation: @Sendable @escaping () async throws -> T
+  ) async rethrows -> T {
+    try await Self.withLogger(options, operation: operation)
+  }
+
+  @discardableResult
+  static func withLogger<T>(
+    _ options: LoggingOptions,
+    operation: @Sendable @escaping () async throws -> T
+  ) async rethrows -> T {
+    try await withDependencies {
+      $0.logger = .init(label: "\(Constants.executableName)")
+      $0.logger.logLevel = options.logLevel
+      $0.logger[metadataKey: "command"] = "\(options.commandName.blue)"
+    } operation: {
+      try await operation()
+    }
+  }
+}