dsajanice / config-rs

⚙️ Layered configuration system for Rust applications (with strong support for 12-factor applications).

config-rs

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 and HJSON 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 )

Usage

[dependencies]
config = "0.8"

• json - Adds support for reading JSON files
• hjson - Adds support for reading HJSON files
• yaml - Adds support for reading YAML files
• toml - Adds support for reading TOML files (included by default)

See the documentation or examples for more usage information.

License

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.