Struct ResolvedConfiguration 

pub struct ResolvedConfiguration { /* private fields */ }

One immutable, lazily materialized phase configuration combination.

Implementations

impl ResolvedConfiguration

pub fn ordinal(&self) -> u64

Returns the flattened ordinal within this phase configuration.

pub fn phase_group(&self) -> &str

Returns the stable string key of the containing phase group.

pub fn phase(&self) -> &str

Returns the stable string key of the selected phase.

pub fn global_ordinal(&self) -> u64

Returns the selection ordinal contributed by the global scope.

pub fn group_ordinal(&self) -> u64

Returns the selection ordinal contributed by the group shared scope.

pub fn phase_ordinal(&self) -> u64

Returns the selection ordinal contributed by the phase-local scope.

pub fn value(&self, key: &str) -> Option<&Value>

Borrows an exact leaf or lazily reconstructed nested subtree.

pub fn require_value(&self, key: &str) -> Result<&Value, ConfigurationError>

Borrows a required value or returns an ordinal-qualified error.

pub fn decode_value<T>(&self, key: &str) -> Result<T, ConfigurationError>

where T: DeserializeOwned,

Deserializes one exact leaf or reconstructed subtree into T.

pub fn decode_values<Values, Keys>( &self, keys: Keys, ) -> Result<Values, ConfigurationError>

where Keys: ParameterKeyTuple<Values>,

Deserializes a tuple of required paths without an intermediate struct.

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

Reports whether this resolved combination contains key or descendants.

pub fn len(&self) -> usize

Returns the number of resolved terminal values.

pub fn is_empty(&self) -> bool

Reports whether the resolved document contains no terminal values.

pub fn keys(&self) -> impl Iterator<Item = &str>

Iterates canonical terminal parameter identifiers.

pub fn iter(&self) -> impl Iterator<Item = (&str, &Value)>

Iterates resolved terminal keys and borrowed values in declaration order.

pub fn to_json(&self) -> String

Serializes the complete rehydrated nested configuration document.

pub fn to_json_value(&self) -> Value

Clones the complete rehydrated nested configuration document.

The document is cached after its first reconstruction. This method is intended for durable provenance records that must own their JSON value.

Trait Implementations

impl Clone for ResolvedConfiguration

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResolvedConfiguration

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

Formats the value using the given formatter.