Struct SourcedValue 

pub struct SourcedValue<T> {
    pub value: T,
    pub source: ConfigSource,
    pub origin: Option<String>,
}

A config value with its provenance: which kind of source set it, and for file-based sources, which file. The origin makes rumdl config output file-precise, which matters for extends chains where the source kind alone cannot distinguish the base config from the extending one.

Fields

value: T

source: ConfigSource

origin: Option<String>

Path of the config file that supplied the winning value. None for defaults and CLI flags.

Implementations

impl<T: Clone> SourcedValue<T>

pub fn new(value: T, source: ConfigSource) -> Self

pub fn merge_override( &mut self, new_value: T, new_source: ConfigSource, new_origin: Option<String>, )

Merges a new value into this SourcedValue based on source precedence. If the new source has higher or equal precedence, the value, source, and origin are replaced.

pub fn merge_from(&mut self, other: SourcedValue<T>)

Merge another SourcedValue with replace semantics.

pub fn push_override( &mut self, value: T, source: ConfigSource, origin: Option<String>, )

Sets the value unconditionally (no precedence check). Used while parsing a single file, where later keys legitimately replace earlier ones regardless of source.

impl<T: Clone + Eq + Hash> SourcedValue<Vec<T>>

pub fn merge_union( &mut self, new_value: Vec<T>, new_source: ConfigSource, new_origin: Option<String>, )

Merges a new value using union semantics (for arrays like extend-disable): values from both sources are combined, with deduplication. The origin reflects the most recent contributor.

pub fn merge_union_from(&mut self, other: SourcedValue<Vec<T>>)

Merge another SourcedValue with union semantics.

Trait Implementations

impl<T: Clone> Clone for SourcedValue<T>

fn clone(&self) -> SourcedValue<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for SourcedValue<T>

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

Formats the value using the given formatter.