Enum Value 

pub enum Value {
    Null,
    Bool(bool),
    Integer(i64),
    Float(f64),
    String(String),
    Bytes(Vec<u8>),
    Sequence(Vec<Value>),
    Mapping(IndexMap<String, Value>),
}

A configuration value that may contain unresolved interpolations

The Bytes variant stores raw binary data and serializes to base64 in YAML/JSON.

Variants

Null

Null value

Bool(bool)

Boolean value

Integer(i64)

Integer value

Float(f64)

Floating point value

String(String)

String value (may contain interpolations like ${env:VAR})

Bytes(Vec<u8>)

Binary data (serializes to base64)

Sequence(Vec<Value>)

Sequence of values

Mapping(IndexMap<String, Value>)

Mapping of string keys to values

Implementations

impl Value

pub fn is_null(&self) -> bool

Check if this value is null

pub fn is_bool(&self) -> bool

Check if this value is a boolean

pub fn is_integer(&self) -> bool

Check if this value is an integer

pub fn is_float(&self) -> bool

Check if this value is a float

pub fn is_string(&self) -> bool

Check if this value is a string

pub fn is_sequence(&self) -> bool

Check if this value is a sequence

pub fn is_mapping(&self) -> bool

Check if this value is a mapping

pub fn is_bytes(&self) -> bool

Check if this value is bytes

pub fn as_bool(&self) -> Option<bool>

Get as boolean if this is a Bool

pub fn as_i64(&self) -> Option<i64>

Get as i64 if this is an Integer

pub fn as_f64(&self) -> Option<f64>

Get as f64 if this is a Float or Integer

pub fn as_str(&self) -> Option<&str>

Get as str if this is a String

pub fn as_sequence(&self) -> Option<&[Value]>

Get as slice if this is a Sequence

pub fn as_mapping(&self) -> Option<&IndexMap<String, Value>>

Get as mapping if this is a Mapping

pub fn as_bytes(&self) -> Option<&[u8]>

Get as bytes if this is Bytes

pub fn get_path(&self, path: &str) -> Result<&Value>

Get a value by path (e.g., “database.host” or “servers[0].name”)

pub fn get_path_mut(&mut self, path: &str) -> Result<&mut Value>

Get a mutable value by path

pub fn set_path(&mut self, path: &str, value: Value) -> Result<()>

Set a value at a path, creating intermediate mappings as needed

pub fn type_name(&self) -> &'static str

Returns the type name of this value

pub fn merge(&mut self, other: Value)

Merge another value into this one (deep merge per ADR-004)

Merge semantics:

• Mappings: Deep merge recursively
• Scalars: other wins (last-writer-wins)
• Sequences: other replaces entirely
• Null in other: Removes the key (handled by caller)
• Type mismatch: other wins

pub fn merged(self, other: Value) -> Value

Create a merged value from two values (non-mutating)

pub fn merge_tracking_sources( &mut self, other: Value, source: &str, path_prefix: &str, sources: &mut HashMap<String, String>, )

Merge another value into this one while tracking source files

Like merge(), but also records which file each leaf value came from. The sources map is updated to reflect the final source of each path.

pub fn collect_leaf_paths( &self, path_prefix: &str, source: &str, sources: &mut HashMap<String, String>, )

Collect all leaf paths from this value and record their source

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

impl Default for Value

fn default() -> Value

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Value

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Value

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

Formats the value using the given formatter.

impl From<&str> for Value

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<IndexMap<String, Value>> for Value

fn from(m: IndexMap<String, Value>) -> Self

Converts to this type from the input type.

impl From<String> for Value

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<Value> for ResolvedValue

fn from(value: Value) -> Self

Converts to this type from the input type.

impl<T: Into<Value>> From<Vec<T>> for Value

fn from(v: Vec<T>) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Value

fn from(bytes: Vec<u8>) -> Self

Converts to this type from the input type.

impl From<bool> for Value

fn from(b: bool) -> Self

Converts to this type from the input type.

impl From<f64> for Value

fn from(f: f64) -> Self

Converts to this type from the input type.

impl From<i32> for Value

fn from(i: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Value

fn from(i: i64) -> Self

Converts to this type from the input type.

impl PartialEq for Value

fn eq(&self, other: &Value) -> 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 Serialize for Value

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Value