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.

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

Validates that keys are non-empty and unique.

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

Validates that all categories belong to allowed_categories.

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

Validates a storage string for a known key.

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.

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.

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.

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.

Trait Implementations

impl Debug for ConfigRegistry

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

Formats the value using the given formatter.