Add custom print function to ConfigLoaderBuilder (#367)

Author: thomas4019

hoplite-core/src/main/kotlin/com/sksamuel/hoplite/ConfigLoader.kt

@@ -11,6 +11,7 @@ import com.sksamuel.hoplite.internal.ConfigParser
 import com.sksamuel.hoplite.internal.DecodeMode
 import com.sksamuel.hoplite.parsers.ParserRegistry
 import com.sksamuel.hoplite.preprocessor.Preprocessor
+import com.sksamuel.hoplite.report.Print
 import com.sksamuel.hoplite.secrets.Obfuscator
 import com.sksamuel.hoplite.secrets.PrefixObfuscator
 import com.sksamuel.hoplite.secrets.SecretsPolicy
@@ -36,6 +37,7 @@ class ConfigLoader(
   val secretsPolicy: SecretsPolicy? = null,
   val environment: Environment? = null,
   val obfuscator: Obfuscator? = null,
+  val reportPrintFn: Print? = null,
   val flattenArraysToString: Boolean = false,
 ) {
 
@@ -155,6 +157,7 @@ class ConfigLoader(
       decodeMode = decodeMode,
       useReport = useReport,
       obfuscator = obfuscator ?: PrefixObfuscator(3),
+      reportPrintFn = reportPrintFn ?: { println(it) },
       environment = environment,
     ).decode(kclass, environment, resourceOrFiles, propertySources, configSources)
   }
@@ -204,6 +207,7 @@ class ConfigLoader(
       decodeMode = DecodeMode.Lenient,  // not used when loading nodes
       useReport = false,  // not used when loading nodes
       obfuscator = StrictObfuscator("*"),  // not used when loading nodes
+      reportPrintFn = reportPrintFn ?: { }, // not used when loading nodes
       environment = environment,
     ).load(resourceOrFiles, propertySources, configSources)
   }

hoplite-core/src/main/kotlin/com/sksamuel/hoplite/ConfigLoaderBuilder.kt

@@ -11,6 +11,7 @@ import com.sksamuel.hoplite.preprocessor.EnvOrSystemPropertyPreprocessor
 import com.sksamuel.hoplite.preprocessor.LookupPreprocessor
 import com.sksamuel.hoplite.preprocessor.Preprocessor
 import com.sksamuel.hoplite.preprocessor.RandomPreprocessor
+import com.sksamuel.hoplite.report.Print
 import com.sksamuel.hoplite.report.Reporter
 import com.sksamuel.hoplite.secrets.AllStringNodesSecretsPolicy
 import com.sksamuel.hoplite.secrets.Obfuscator
@@ -42,6 +43,7 @@ class ConfigLoaderBuilder private constructor() {
   private val decoders = mutableListOf<Decoder<*>>()
 
   private var useReport: Boolean = false
+  private var reportPrintFn: Print = { println(it) }
   private var secretsPolicy: SecretsPolicy = AllStringNodesSecretsPolicy
   private var obfuscator: Obfuscator = PrefixObfuscator(3)
   private var preprocessingIterations: Int = 1
@@ -221,6 +223,8 @@ class ConfigLoaderBuilder private constructor() {
   fun withObfusctator(obfuscator: Obfuscator): ConfigLoaderBuilder = withObfuscator(obfuscator)
   fun withObfuscator(obfuscator: Obfuscator): ConfigLoaderBuilder = apply { this.obfuscator = obfuscator }
 
+  fun withReportPrintFn(reportPrintFn: (String) -> Unit): ConfigLoaderBuilder = apply { this.reportPrintFn = reportPrintFn }
+
   @ExperimentalHoplite
   fun withSecretsPolicy(secretsPolicy: SecretsPolicy) = apply { this.secretsPolicy = secretsPolicy }
 
@@ -262,6 +266,7 @@ class ConfigLoaderBuilder private constructor() {
       secretsPolicy = secretsPolicy,
       environment = environment,
       obfuscator = obfuscator,
+      reportPrintFn = reportPrintFn,
       flattenArraysToString = flattenArraysToString,
     )
   }

hoplite-core/src/main/kotlin/com/sksamuel/hoplite/internal/ConfigParser.kt

@@ -16,6 +16,7 @@ import com.sksamuel.hoplite.fp.invalid
 import com.sksamuel.hoplite.fp.valid
 import com.sksamuel.hoplite.parsers.ParserRegistry
 import com.sksamuel.hoplite.preprocessor.Preprocessor
+import com.sksamuel.hoplite.report.Print
 import com.sksamuel.hoplite.report.Reporter
 import com.sksamuel.hoplite.secrets.Obfuscator
 import com.sksamuel.hoplite.secrets.SecretsPolicy
@@ -36,6 +37,7 @@ class ConfigParser(
   private val decodeMode: DecodeMode,
   private val useReport: Boolean,
   private val obfuscator: Obfuscator,
+  private val reportPrintFn: Print,
   private val environment: Environment?,
 ) {
 
@@ -73,7 +75,7 @@ class ConfigParser(
 
         // always do report regardless of decoder result
         if (useReport) {
-          Reporter({ println(it) }, obfuscator, environment)
+          Reporter(reportPrintFn, obfuscator, environment)
             .printReport(propertySources, state, context.reports)
         }