Expand description
configbuilder-pattern-loader — the loader domain’s trait contract (Loader,
LoaderOps, ConfigSection, OptionalSection, SectionLoaderBound, the
Feature*Ops traits, ConfigError) and its tech-agnostic reference
implementation: DefaultLoader (the { ops: Box<dyn LoaderOps> } generic
dispatch shell, renamed off *Impl here — it doesn’t care what real LoaderOps
implementor is boxed inside) and the in-memory feature bookkeeping
(FeatureRegistry/FeatureRecordBuilder/FeatureMetadata/FeatureState/
FeatureSummary/OverrideSource/Topology).
The real, filesystem/TOML-backed LoaderOps implementor lives in
configbuilder-svc-loader-spi instead.
Macros§
- load_
in_ order - Load a set of optional feature sections in dependency order.
Structs§
- Default
Loader - Reference
Loader/FeatureLoaderimplementation: a generic dispatch shell over any realLoaderOpsimplementor. - Feature
Metadata - Static documentation and ownership annotations for an optional feature.
- Feature
Record - A snapshot of one optional feature’s resolved state.
- Feature
Record Builder - Fluent builder for
FeatureRecord. - Feature
Registry - Collects feature-load metadata at startup for all optional TOML sections.
- Feature
Summary - A point-in-time snapshot of every feature loaded through the registry facade.
- Loaded
Feature - The full result of loading an optional feature section.
- RawFeature
- Raw output of a feature load before generic deserialisation.
- Topology
- Topological dependency resolver for feature load ordering.
Enums§
- Config
Error - Errors returned by config loading and validation operations.
- Feature
State - Whether an optional TOML section is present and active.
- OnError
- Controls what the feature registry does when
OptionalSection::validate_enabledreturns an error for an otherwise-enabled section. - Override
Source - Records which external control overrode a feature’s natural TOML state.
Traits§
- Config
Section - Marks a typed struct as the owner of a named TOML section.
- Feature
Loader - Load optional TOML sections with configurable enable/disable precedence.
- Feature
Record Builder Ops - Fluent builder operations for constructing
FeatureRecordinstances. - Feature
Registry Ops - Startup feature registry: collection, dependency validation, and observation.
- Feature
State Ops - Operations on
FeatureState<T>— presence-driven feature gate. - Feature
Summary Ops - Read-only queries on a
crate::FeatureSummarysnapshot. - Loader
- Load typed TOML sections from a layered config chain.
- Loader
Ops - Type-erased view of a config source used internally by
crate::DefaultLoader. - Optional
Section - Marks a typed struct as an opt-in TOML feature section.
- Section
Loader Bound - API contract marker for the reference section loader.
- Topology
Ops - Topological dependency resolver for feature load ordering.