31 releases

0.14.1 Oct 23, 2024
0.14.0 Feb 1, 2024
0.13.4 Nov 22, 2023
0.13.3 Dec 4, 2022
0.1.1 Apr 30, 2015

#1 in Configuration

Download history 279314/week @ 2024-08-04 308093/week @ 2024-08-11 311717/week @ 2024-08-18 301796/week @ 2024-08-25 293885/week @ 2024-09-01 299566/week @ 2024-09-08 297835/week @ 2024-09-15 331475/week @ 2024-09-22 317247/week @ 2024-09-29 338628/week @ 2024-10-06 338655/week @ 2024-10-13 362259/week @ 2024-10-20 345810/week @ 2024-10-27 356312/week @ 2024-11-03 339503/week @ 2024-11-10 338694/week @ 2024-11-17

1,401,148 downloads per month
Used in 1,240 crates (751 directly)

MIT/Apache

155KB
3.5K SLoC

config-rs

Rust Build Status Crates.io Docs.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, 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 this library

  • can not be used to write changed configuration values back to the configuration file(s)!
  • Is case insensitive and all the keys are converted to lowercase internally

Usage

[dependencies]
config = "0.14.0"

Feature flags

  • 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

Support for custom formats

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_file_format example for more information.

More

See the documentation or examples for more usage information.

License

Licensed under either of

at your option.

Dependencies

~1.9–4MB
~76K SLoC