Struct ConfigRegistry 

pub struct ConfigRegistry { /* private fields */ }

Static registry of product configuration definitions.

Implementations

impl ConfigRegistry

pub const fn new(definitions: &'static [ConfigDefinition]) -> Self

Creates a registry from a static definition slice.

pub const fn definitions(&self) -> &'static [ConfigDefinition]

Returns all registered definitions.

pub fn get(&self, key: &str) -> Option<&'static ConfigDefinition>

Returns the definition for key.

pub fn contains_key(&self, key: &str) -> bool

Returns whether key is registered.

pub fn require(&self, key: &str) -> Result<&'static ConfigDefinition>

Returns the definition for key or an unknown-key error.

Errors

Returns [ConfigError] when the requested configuration key is not registered.

pub fn validate_unique_keys(&self) -> Result<()>

Validates that keys are non-empty and unique.

Errors

Returns [ConfigError] when the registry contains duplicate configuration keys.

pub fn validate_categories(&self, allowed_categories: &[&str]) -> Result<()>

Validates that all categories belong to allowed_categories.

Errors

Returns [ConfigError] when a definition category violates registry constraints.

pub fn validate_value(&self, key: &str, value: &str) -> Result<()>

Validates a storage string for a known key.

Errors

Returns [ConfigError] when the stored value or a dependency rule is invalid.

pub fn normalize_value( &self, lookup: &dyn ConfigValueLookup, key: &str, value: &str, ) -> Result<String>

Normalizes a storage string for a known key.

The input is expected to already match the structural storage shape for the definition’s value type, for example a JSON string array for string_array.

Errors

Returns [ConfigError] when the definition normalizer rejects the value.

pub fn value_to_normalized_storage( &self, lookup: &dyn ConfigValueLookup, key: &str, value: &ConfigValue, ) -> Result<String>

Converts an API-facing value into normalized storage for a known key.

Errors

Returns [ConfigError] when the typed value cannot be normalized for storage.

pub fn value_to_storage_for_key( &self, lookup: &dyn ConfigValueLookup, key: &str, value: &ConfigValue, ) -> Result<String>

Converts an API-facing value into storage for either a registered key or a custom key.

Registered keys use their declared ConfigValueType and run through the full registry normalization pipeline. Custom keys are treated as scalar strings by default, leaving their visibility, permissions, and persistence policy to the product crate.

Errors

Returns [ConfigError] when the key is unknown or its typed value is invalid.

pub fn apply_definition(&self, config: StoredConfig) -> StoredConfig

Applies definition metadata to a system-owned stored row.

pub fn default_seed_records(&self) -> Result<Vec<ConfigSeedRecord>>

Builds default seed rows from the registry.

Defaults are normalized in registry order. If a normalizer or dependency validator consults another config key, that dependency should appear earlier in the registry.

Errors

Returns [ConfigError] when definitions are duplicated or a default value is invalid.

Trait Implementations

impl Debug for ConfigRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.