Configur8 
Nano-library which provides the ability to define typesafe (!) Configuration templates for applications.
Concept:
A Configuration is a set of named and typed Property instances, which are defined using a ConfigurationTemplate. Each defined Property can be set with a default value, or be blank with a requirement to be overridden. At runtime, the template is reified into a concrete Configuration object, but if any properties are missing this process will throw a Misconfiguration error.
Assuming that the reification process is successful, property values can be retrieved in an (actually) type-safe manner, and are applied in the following descending order of precedence:
- JVM system property
- Named environment property
- Default value
Quick example
This is from the Kotlin version, but the Scala and Java APIs are broadly the same:
// simple typed values
val USER = Property.string("USER")
val AGE = Property.int("AGE")
// provide custom mapping functions to convert from strings to domain
val PATIENCE_LEVEL = Property("DURATION", { i: String -> Duration.parse(i) }, { it.describe() })
// build your template
val configTemplate = ConfigurationTemplate()
.requiring(USER) // will be supplied by the environment
.withProp(AGE, 2) // falls back to a default typed value
.withProp(PATIENCE_LEVEL, Duration(10)) // custom typed property with default
// attempting to build a configuration with missing values will fail with a Misconfiguration exception
val config = configTemplate.reify()
// retrieval of values in a typesafe way
val patience: Duration = config.valueOf[PATIENCE_LEVEL]
Get it:
Currently, the library is published in Java, Kotlin and Scala versions in JCenter (and synced to Maven Central).
Maven:
Java:
<dependency>
<groupId>io.github.daviddenton</groupId>
<artifactId>configur8</artifactId>
<version>1.7.0</version>
</dependency>
Kotlin:
<dependency>
<groupId>io.github.daviddenton</groupId>
<artifactId>konfigur8</artifactId>
<version>1.7.0</version>
</dependency>
SBT:
libraryDependencies += "io.github.daviddenton" %% "configur8" % "1.7.0"
936 Dec 19, 2022
939 Dec 23, 2022
20.2k Jan 5, 2023
7.1k Jan 5, 2023
8.3k Jan 5, 2023
2.3k Jan 5, 2023
996 Dec 28, 2022
3 Dec 12, 2021
38 Dec 11, 2022
44 Sep 13, 2022
1.3k Dec 23, 2022
5 Oct 31, 2021
5 Sep 23, 2022
3 Oct 11, 2022
77 Nov 28, 2022
53 Nov 21, 2022
6 Aug 30, 2022
27.6k Jan 5, 2023
274 Jan 3, 2023