commit	1bac1e09799a9826e7fa0a24d651ec000be4f5bf	[log] [tgz]
author	Jeongik Cha <jeongik@google.com>	Thu Sep 14 16:31:23 2023 +0900
committer	Jeongik Cha <jeongik@google.com>	Wed Sep 27 03:09:05 2023 +0900
tree	1d8ee82a8ceb5276c1ae961bdb7c5b710966f685
parent	919c1e4e74e1a5907ba6e6d75e4af0821df1e725 [diff]

Import config

Bug: 277909042
Test: build
Change-Id: I218865d5f55426431158e3eb259d6c085bda0fb7

.cargo_vcs_info.json[Added - diff]
.clippy.toml[Added - diff]
.editorconfig[Added - diff]
.github/dependabot.yml[Added - diff]
.github/workflows/fixupmerge.yml[Added - diff]
.github/workflows/msrv.yml[Added - diff]
.gitignore[Added - diff]
Android.bp[Added - diff]
CHANGELOG.md[Added - diff]
Cargo.toml[Added - diff]
Cargo.toml.orig[Added - diff]
LICENSE[Added - diff]
LICENSE-APACHE[Added - diff]
LICENSE-MIT[Added - diff]
METADATA[Added - diff]
MODULE_LICENSE_APACHE2[Added - diff]
MODULE_LICENSE_MIT[Added - diff]
OWNERS[Added - diff]
README.md[Added - diff]
examples/async_source/main.rs[Added - diff]
examples/custom_format/main.rs[Added - diff]
examples/env-list/main.rs[Added - diff]
examples/glob/conf/00-default.toml[Added - diff]
examples/glob/conf/05-some.yml[Added - diff]
examples/glob/conf/99-extra.json[Added - diff]
examples/glob/main.rs[Added - diff]
examples/global/main.rs[Added - diff]
examples/hierarchical-env/config/default.toml[Added - diff]
examples/hierarchical-env/config/development.toml[Added - diff]
examples/hierarchical-env/config/production.toml[Added - diff]
examples/hierarchical-env/main.rs[Added - diff]
examples/hierarchical-env/settings.rs[Added - diff]
examples/simple/Settings.toml[Added - diff]
examples/simple/main.rs[Added - diff]
examples/watch/Settings.toml[Added - diff]
examples/watch/main.rs[Added - diff]
src/builder.rs[Added - diff]
src/config.rs[Added - diff]
src/de.rs[Added - diff]
src/env.rs[Added - diff]
src/error.rs[Added - diff]
src/file/format/ini.rs[Added - diff]
src/file/format/json.rs[Added - diff]
src/file/format/json5.rs[Added - diff]
src/file/format/mod.rs[Added - diff]
src/file/format/ron.rs[Added - diff]
src/file/format/toml.rs[Added - diff]
src/file/format/yaml.rs[Added - diff]
src/file/mod.rs[Added - diff]
src/file/source/file.rs[Added - diff]
src/file/source/mod.rs[Added - diff]
src/file/source/string.rs[Added - diff]
src/format.rs[Added - diff]
src/lib.rs[Added - diff]
src/map.rs[Added - diff]
src/path/mod.rs[Added - diff]
src/path/parser.rs[Added - diff]
src/ser.rs[Added - diff]
src/source.rs[Added - diff]
src/value.rs[Added - diff]
tests/Settings-invalid.hjson[Added - diff]
tests/Settings-invalid.ini[Added - diff]
tests/Settings-invalid.json[Added - diff]
tests/Settings-invalid.json5[Added - diff]
tests/Settings-invalid.ron[Added - diff]
tests/Settings-invalid.toml[Added - diff]
tests/Settings-invalid.yaml[Added - diff]
tests/Settings-production.toml[Added - diff]
tests/Settings.hjson[Added - diff]
tests/Settings.ini[Added - diff]
tests/Settings.json[Added - diff]
tests/Settings.json5[Added - diff]
tests/Settings.ron[Added - diff]
tests/Settings.toml[Added - diff]
tests/Settings.yaml[Added - diff]
tests/Settings2.default.ini[Added - diff]
tests/async_builder.rs[Added - diff]
tests/datetime.rs[Added - diff]
tests/defaults.rs[Added - diff]
tests/empty.rs[Added - diff]
tests/env.rs[Added - diff]
tests/errors.rs[Added - diff]
tests/file.rs[Added - diff]
tests/file_ini.rs[Added - diff]
tests/file_json.rs[Added - diff]
tests/file_json5.rs[Added - diff]
tests/file_ron.rs[Added - diff]
tests/file_toml.rs[Added - diff]
tests/file_yaml.rs[Added - diff]
tests/get.rs[Added - diff]
tests/integer_range.rs[Added - diff]
tests/legacy/datetime.rs[Added - diff]
tests/legacy/env.rs[Added - diff]
tests/legacy/errors.rs[Added - diff]
tests/legacy/file.rs[Added - diff]
tests/legacy/file_ini.rs[Added - diff]
tests/legacy/file_json.rs[Added - diff]
tests/legacy/file_ron.rs[Added - diff]
tests/legacy/file_toml.rs[Added - diff]
tests/legacy/file_yaml.rs[Added - diff]
tests/legacy/get.rs[Added - diff]
tests/legacy/merge.rs[Added - diff]
tests/legacy/mod.rs[Added - diff]
tests/legacy/set.rs[Added - diff]
tests/legacy_tests.rs[Added - diff]
tests/merge.rs[Added - diff]
tests/set.rs[Added - diff]
tests/types/i64.toml[Added - diff]
tests/weird_keys.rs[Added - diff]

109 files changed

tree: 1d8ee82a8ceb5276c1ae961bdb7c5b710966f685

README.md

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, 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.

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.