Layered configuration system for Rust applications (with strong support for 12-factor applications).
- Set defaults
- Set explicit values (to programmatically override)
- Read from JSON, 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 configuration values back to the configuration file(s)!
[dependencies]
config = "0.13.1"ini- Adds support for reading INI filesjson- Adds support for reading JSON filesyaml- Adds support for reading YAML filestoml- Adds support for reading TOML filesron- Adds support for reading RON filesjson5- 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 - a Format trait that, once implemented, allows seamless integration with library's APIs using custom, less popular or proprietary data formats.
See custom_format example for more information.
See the documentation or examples for more usage information.
We currently support Rust 1.56.1 and newer.
config-rs is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See LICENSE-APACHE and LICENSE-MIT for details.