Enum ConfigValue 

#[repr(u8)]
pub enum ConfigValue {
    Null(Sourced<()>),
    Bool(Sourced<bool>),
    Integer(Sourced<i64>),
    Float(Sourced<f64>),
    String(Sourced<String>),
    Array(Sourced<Vec<ConfigValue>>),
    Object(Sourced<IndexMap<String, ConfigValue, RandomState>>),
    Enum(Sourced<EnumValue>),
}

A configuration value with full provenance tracking at every level.

Variants

Null(Sourced<()>)

A null value.

Bool(Sourced<bool>)

A boolean value.

Integer(Sourced<i64>)

An integer value.

Float(Sourced<f64>)

A floating-point value.

String(Sourced<String>)

A string value.

Array(Sourced<Vec<ConfigValue>>)

An array of values.

Object(Sourced<IndexMap<String, ConfigValue, RandomState>>)

An object/map of key-value pairs.

Enum(Sourced<EnumValue>)

An enum value (subcommand or enum field in config).

Implementations

impl ConfigValue

pub fn visit( &self, visitor: &mut impl ConfigValueVisitor, path: &mut Vec<String>, )

Visit all ConfigValue nodes in depth-first order.

pub fn visit_mut( &mut self, visitor: &mut impl ConfigValueVisitorMut, path: &mut Vec<String>, )

Visit all ConfigValue nodes mutably in depth-first order.

pub fn span(&self) -> Option<Span>

Get the span of this value (regardless of variant).

pub fn span_mut(&mut self) -> &mut Option<Span>

Get a mutable reference to the span of this value.

pub fn provenance(&self) -> Option<&Provenance>

Get the provenance of this value (regardless of variant).

pub fn get_by_path(&self, path: &Vec<String>) -> Option<&ConfigValue>

Navigate to a value by path.

pub fn get_by_path_mut( &mut self, path: &Vec<String>, ) -> Option<&mut ConfigValue>

Navigate to a value by path (mutable).

pub fn set_file_provenance_recursive( &mut self, file: &Arc<ConfigFile>, path: &str, )

Recursively set file provenance on this value and all nested values.

This should be called after parsing a config file to populate provenance on the entire tree.

pub fn extract_subcommand_path( &self, subcommand_field_name: &str, ) -> Vec<String>

Extract the selected subcommand path from a ConfigValue.

Given a ConfigValue representing parsed CLI args, this extracts the chain of selected subcommands. For example, if the user ran myapp repo clone --help, this would return ["Repo", "Clone"] (using variant names, not CLI names).

The subcommand_field_name is the name of the field that holds the subcommand at the root level (e.g., “command” for #[facet(args::subcommand)] command: Command).

Trait Implementations

impl Clone for ConfigValue

fn clone(&self) -> ConfigValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigValue

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

Formats the value using the given formatter.

impl<'ʄ> Facet<'ʄ> for ConfigValue

const SHAPE: &'static Shape

The shape of this type, including: whether it’s a Struct, an Enum, something else?