Crate config

Expand description

Config organizes hierarchical or layered configurations for Rust applications.

Config lets you set a set of default parameters and then extend them via merging in configuration from a variety of sources:

Environment variables
String literals in well-known formats
Another Config instance
Files: TOML, JSON, YAML, INI, RON, JSON5 and custom ones defined with Format trait
Manual, programmatic override (via a .set method on the Config instance)

Additionally, Config supports:

Live watching and re-reading of configuration files
Deep access into the merged configuration via a path syntax
Deserialization via serde of the configuration or any subset defined via a path

See the examples for general usage information.

Re-exports§

Config
A prioritized configuration repository. It maintains a set of configuration sources, fetches values to populate those, and provides them according to the source’s priority.
Environment
An environment source collects a dictionary of environment variables values into a hierarchical config Value type. We have to be aware how the config tree is created from the environment dictionary, therefore we are mindful about prefixes for the environment keys, level separators, encoding form (kebab, snake case) etc.
File
A configuration source backed up by a file.
FileSourceFile
Describes a file sourced from a file
FileSourceString
Describes a file sourced from a string
Value
A configuration value.

Caseconvert-case
Defines the type of casing a string can be.
ConfigError
Represents all possible errors that can occur when working with configuration.
FileFormat
File formats provided by the library.
ValueKind
Underlying kind of the configuration value.

AsyncSourceasync
Describes a generic source of configuration properties capable of using an async runtime.
FileSource
Describes where the file is sourced
FileStoredFormat
An extension of Format trait.
Format
Describes a format of configuration source data
Source
Describes a generic source of configuration properties.