Google Git
Sign in
android / platform / external / rust / crates / config / refs/heads/android14-qpr2-s4-release
commit075d7de68d1ee73b23e7d21e17bd47caf3c328e7[log] [tgz]
authorAndroid Build Coastguard Worker <[email protected]>Wed Nov 15 00:11:07 2023 +0000
committerAndroid Build Coastguard Worker <[email protected]>Wed Nov 15 00:11:07 2023 +0000
tree8042e356a222bccce8de8ea3b56ac839459bdfb0
parent8e30cfbbdc2140964c465290401740a655882314 [diff]
parenteee98e227a0a474148c55d04a8d7f02aa05b93ec [diff]
Snap for 11097608 from eee98e227a0a474148c55d04a8d7f02aa05b93ec to 24Q1-release

Change-Id: Ib67a16a9b44e4bc943219db071757ec353d6d477
tree: 8042e356a222bccce8de8ea3b56ac839459bdfb0
  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.toml
  11. Cargo.toml.orig
  12. cargo_embargo.json
  13. CHANGELOG.md
  14. LICENSE
  15. LICENSE-APACHE
  16. LICENSE-MIT
  17. METADATA
  18. MODULE_LICENSE_APACHE2
  19. MODULE_LICENSE_MIT
  20. OWNERS
  21. 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.