ZIO Config
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. 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>"
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