Google Git
Sign in
android / platform / external / rust / crates / config / a536a4253ba00d0e61961b69639ba460d03fe97e
commita536a4253ba00d0e61961b69639ba460d03fe97e[log] [tgz]
authorXin Li <[email protected]>Mon Apr 29 22:54:46 2024 +0000
committerAutomerger Merge Worker <[email protected]>Mon Apr 29 22:54:46 2024 +0000
tree1bb715ddbe40d66b63866c4a84f4eb05cadcd570
parent6ce1a4e28738c1fa182408c670e787589f835521 [diff]
parent483e7ea4bd9b61fe67fb6c4aa92366aee280de80 [diff]
[automerger skipped] Empty merge of Android 24Q2 Release (ab/11526283) to aosp-main-future am: 483e7ea4bd -s ours

am skip reason: Merged-In I9f3c217cbef854ecf6ea54f1196b19a2e55531bb with SHA-1 72b6c1812d is already in history

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

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