manaconf
A library for creating a layered configuration provider
This library gives you the ability to setup to read configuration to read from multiple sources, and pull values from these sources via a key.
Inspired by dotnetcore configuration system. (Though this is no where near as deep)
// create our config to read configuration values from environment variables
// with the prefix MYAPP
let config = new
.with_source
.build;
// Read our config data in
let config_data: ConfigData = config.bind?;
Keys
Keys are a heirachy represented as a string, i.e. section::subsection::value
,
which can be used to drill down into configurations that may have an arbitary
depth of value organization.
Different sources may interpret this heirachy in different ways. For example
the EnvVarSource
will just turn this into an uppercased string, where the
seperators are replaced with underscores. (SECTION_SUBSECTION_VALUE
).
But a json source might use this as a way to drill down into sub objects.
Sections
You can call the section
method on both Config
and Section
types to create
a section
. As section is simply a pre-applied prefix to your key.
Useful when some code would not or should not be aware of the parent heirachy.
For example, if we took our type above, but in fact our values important
and
optional
actually didn't sit at the root but was instead at some::subsection
we can use Section
to give that code access to values as if the Section
's
prefix was the root.
let section = config.section;
let config_data: ConfigData = section.bind;
// Even though ConfigData only asks for `important` and `optional` due to the
// `Section`, the actual keys being looked up is `some::subsection::important` and
// `some::subsection::optional`.
Multiple sources
At the moment manaconf only provides one source type, but when new sources are added you can configure your configuration to pull from all these source at once.
The idea being, the order you add your sources is the priority of that source. Each source gets checked in turn until one
TODO
-
More sources
At current there's only the
EnvVarSource
for pulling from environment variables.However I'd like to provide much more than that. Such as command line parameters, toml/json/yml files, .env files, and the like
However, I'm thinking it'd be best to implement other sources as crates.
-
Derive macro
It'd be nice if
TryFromValueRead
could be implemented as a derive macro, though I've not looked into how to do this yet. -
Async support
Might be worth having async support for reading from sources
-
???
We'll see what else falls out with usage