Struct ConfigValue 

pub struct ConfigValue<T> {
    pub value: T,
    pub provenance: Provenance,
}

A configuration value together with the reason it holds that value.

Most model fields are plain values, because their effective value is all a consumer needs. Use ConfigValue<T> for a setting whose behavior depends on whether the value was set explicitly, rather than on the value alone. The primary intake URL is the canonical example: the Core Agent supplies dd_url at its schema default even when the operator configured only site, so the URL alone cannot say whether it should override site.

The value and its provenance are independent, and both are always available. A defaulted setting holds its default value with Provenance::Default, rather than holding no value, so a consumer never has to restate a default the configuration layer already resolved:

if endpoints.dd_url.is_explicit() {
    resolve_verbatim(&endpoints.dd_url.value)
} else {
    resolve_from_site(&endpoints.site.value)
}

Equality covers both fields: a value that keeps its contents but becomes explicit is a change, and a Live view of it wakes.

Serialization emits the value alone, so the shape of a serialized SalukiConfiguration does not depend on which fields track provenance.

Prefer ConfigValue<T> over ConfigValue<Option<T>>. Reaching for the inner Option usually means it is duplicating the provenance: a T with Provenance::Default already expresses “no one configured this”, and the nested form leaves two different ways to say so.

Fields

value: T

The effective value.

provenance: Provenance

Whether an input set value, or it is a default.

Implementations

impl<T> ConfigValue<T>

pub fn new(value: T, provenance: Provenance) -> Self

Creates a value with the given provenance.

pub fn explicit(value: T) -> Self

Creates a value that an input set explicitly.

pub fn defaulted(value: T) -> Self

Creates a default value that nothing set.

pub fn is_explicit(&self) -> bool

Returns whether an input set this value explicitly.

A setting that acts as an override is in force only when this is true: a defaulted value expresses no intent to override anything.

Trait Implementations

impl<T: Clone> Clone for ConfigValue<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ConfigValue<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for ConfigValue<T>

fn default() -> ConfigValue<T>

Returns the “default value” for a type.

impl<T: PartialEq> PartialEq for ConfigValue<T>

fn eq(&self, other: &ConfigValue<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Serialize> Serialize for ConfigValue<T>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<T: Copy> Copy for ConfigValue<T>

impl<T: Eq> Eq for ConfigValue<T>

impl<T> StructuralPartialEq for ConfigValue<T>