Google Git
Sign in
android / platform / external / rust / crates / config / 22e6f6eb6f298f09bd9de2084c7d7223c2bc009c
commit22e6f6eb6f298f09bd9de2084c7d7223c2bc009c[log] [tgz]
authorJames Farrell <[email protected]>Wed Aug 07 23:23:57 2024 +0000
committerAutomerger Merge Worker <[email protected]>Wed Aug 07 23:23:57 2024 +0000
tree61d8e22e064128e91ed71224ab577537fa2527f6
parent206bccf7c189996e6c22cee243930fb4da62bf79 [diff]
parentac3be0eb472f46153303c0f4c23910066a96f0a8 [diff]
Create patch from LICENSE file am: 30bd414b15 am: ac3be0eb47

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/config/+/3211618

Change-Id: Id2012b18563ac5914eba03a583e0552915176c82
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: 61d8e22e064128e91ed71224ab577537fa2527f6
  1. .github/
  2. examples/
  3. patches/
  4. src/
  5. tests/
  6. .cargo_vcs_info.json
  7. .clippy.toml
  8. .editorconfig
  9. .gitignore
  10. Android.bp
  11. Cargo.lock.msrv
  12. Cargo.toml
  13. Cargo.toml.orig
  14. cargo_embargo.json
  15. CHANGELOG.md
  16. LICENSE
  17. LICENSE-APACHE
  18. LICENSE-MIT
  19. METADATA
  20. MODULE_LICENSE_APACHE2
  21. MODULE_LICENSE_MIT
  22. OWNERS
  23. README.md
README.md

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 that this library can not be used to write changed configuration values back to the configuration file(s)!

Usage

[dependencies]
config = "0.13.1"

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

More

See the documentation or examples for more usage information.

MSRV

We currently support Rust 1.56.0 and newer.

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.