ZIO Config
ZIO Config is a ZIO-based library and act as an extension to core library ZIO's Config language.
Let's enumerate some key features of this library:
- Support for Various Sources — It can read flat or nested configurations from HOCON, JSON, YAML, TOML, XML, maps, and more. Thanks to
IndexedFlat. - Automatic Document Generation — It can auto-generate documentation of configurations.
- Automatic Derivation — It has built-in support for automatic derivation of readers and writers for case classes and sealed traits.
- Type-level Constraints and Automatic Validation — because it supports Refined types, we can write type-level predicates which constrain the set of values described for data types.
- Descriptive Errors — It accumulates all errors and reports all of them to the user rather than failing fast.
- Integrations — Integrations with a variety of libraries
If you are only interested in automatic derivation of configuration, find the details here
Installation
In order to use this library, we need to add the following line in our build.sbt file:
libraryDependencies += "dev.zio" %% "zio-config" % "<version>"
Sources
Add the modules you need for your config sources:
// HOCON / JSON
libraryDependencies += "dev.zio" %% "zio-config-typesafe" % "<version>"
// YAML
libraryDependencies += "dev.zio" %% "zio-config-yaml" % "<version>"
// TOML
libraryDependencies += "dev.zio" %% "zio-config-toml" % "<version>"
// XML (experimental)
libraryDependencies += "dev.zio" %% "zio-config-xml" % "<version>"
See Read from various Sources for examples of each.
Quick Start
Let's add these four lines to our build.sbt file as we are using these modules in our examples:
libraryDependencies += "dev.zio" %% "zio-config" % "<version>"
libraryDependencies += "dev.zio" %% "zio-config-magnolia" % "<version>"
libraryDependencies += "dev.zio" %% "zio-config-typesafe" % "<version>"
libraryDependencies += "dev.zio" %% "zio-config-refined" % "<version>"
There are many examples in here
Documentation
Learn more on the ZIO Config homepage!
Contributing
For the general guidelines, see ZIO contributor's guide.
Code of Conduct
See the Code of Conduct
Support
Come chat with us on 
