configbuilder-pattern-loader 0.1.0

configbuilder-pattern: loader domain, trait contract + tech-agnostic reference implementation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

use crate::{
    ConfigError, DefaultLoader, FeatureRecord, FeatureState, FeatureSummary, OptionalSection,
};

/// Startup feature registry: collection, dependency validation, and observation.
///
/// Implemented by [`crate::FeatureRegistry`].
pub trait FeatureRegistryOps: Sized {
    /// Create an empty registry.
    fn new() -> Self;

    /// Register a callback to observe loaded records.
    fn on_load(&mut self, observer: impl Fn(&FeatureRecord) + 'static);

    /// Load a feature section and record its state.
    ///
    /// # Errors
    ///
    /// Propagates any [`ConfigError`] returned by the loader.
    fn load<T>(&mut self, loader: &DefaultLoader) -> Result<FeatureState<T>, ConfigError>
    where
        T: OptionalSection;

    /// Validate that every enabled feature's declared dependencies are enabled.
    ///
    /// # Errors
    ///
    /// Returns [`ConfigError::Validation`] listing all unsatisfied dependencies.
    fn validate_dependencies(&self) -> Result<(), ConfigError>;

    /// Borrow the recorded feature records.
    fn records(&self) -> &[FeatureRecord];

    /// Build a point-in-time snapshot of the recorded features.
    fn summary(&self) -> FeatureSummary;
}