conspiracy

Safe, efficient configuration abstractions.

See docs.rs for full details.

License

This project is licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.

The SPDX license identifier for this project is MIT OR Apache-2.0.

lib.rs:

Conspiracy is an opinionated, extensible configuration crate that applies the "rust ethos" to configuration. It shifts as much validation to compile time as possible, ensures state changes are consistent, and guarantees constructed states are valid through:

• Static typing
• Atomic updates
• Facilities for composition (depending on only a sub-config without resorting to dynamic typing)
• Abstractions for high-performance, lock-free updates

Concepts, Usage, and Examples

See the module documentation for each concept:

• Configuration: config
• Feature Control: feature_control

Future Work

These crates are still experimental. Most updates should expect breaking changes.

Planned features:

• A universal configuration fetcher implementation for runtime configuration updates supporting
  • Layers
  • Serde inputs
• Dynamic evaluation of configuration based on environment context with "Flighting" DSL.
• Enable universal feature tracker to track against a config input, enabling dynamic values + reboot required support.
• Support factoring a config struct into multiple partial definitions.