Repository files navigation

Layered configuration system for Rust applications (with strong support for12-factor applications).

• Set defaults
• Set explicit values (to programmatically override)
• Read fromJSON,TOML,YAML,INI,RON,JSON5 files
• Read from environment
• Loosely typed — Configuration values may be read in any supported type, as long as there exists a reasonable conversion
• Access nested fields using a formatted path — Uses a subset of JSONPath; currently supports the child (redis.port ) and subscript operators (databases[0].name )

Please note that this library can not be used to write changed configurationvalues back to the configuration file(s)!

• ini - Adds support for reading INI files
• json - Adds support for reading JSON files
• yaml - Adds support for reading YAML files
• toml - Adds support for reading TOML files
• ron - Adds support for reading RON files
• json5 - Adds support for reading JSON5 files

Library provides out of the box support for most renowned data formats such as JSON or Yaml. Nonetheless, it contains an extensibility point - aFormat trait that, once implemented, allows seamless integration with library's APIs using custom, less popular or proprietary data formats.

Seecustom_file_format example for more information.

See thedocumentation orexamples formore usage information.

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE orhttp://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT orhttp://opensource.org/licenses/MIT)

at your option.