Struct StackedConfig

pub struct StackedConfig { /* private fields */ }

Stack of configuration layers which can be merged as needed.

Implementations

impl StackedConfig

pub fn empty() -> Self

Creates an empty stack of configuration layers.

pub fn load_file( &mut self, source: ConfigSource, path: impl Into<PathBuf>, ) -> Result<(), ConfigError>

Loads config file from the specified path, inserts it at the position specified by source. The file should exist.

pub fn load_dir( &mut self, source: ConfigSource, path: impl AsRef<Path>, ) -> Result<(), ConfigError>

Loads config files from the specified directory path, inserts them at the position specified by source. The directory should exist.

pub fn add_layer(&mut self, layer: ConfigLayer)

Inserts new layer at the position specified by layer.source.

pub fn remove_layers(&mut self, source: ConfigSource)

Removes layers of the specified source.

pub fn layers(&self) -> &[ConfigLayer]

Layers sorted by precedence.

pub fn get<'de, T: Deserialize<'de>>( &self, name: impl ToConfigNamePath, ) -> Result<T, ConfigError>

Looks up value of the specified type T from all layers, merges sub fields as needed.

pub fn get_value( &self, name: impl ToConfigNamePath, ) -> Result<ConfigValue, ConfigError>

Looks up value from all layers, merges sub fields as needed.

pub fn get_table( &self, name: impl ToConfigNamePath, ) -> Result<ConfigTable, ConfigError>

Looks up sub table from all layers, merges fields as needed.

Trait Implementations

impl Clone for StackedConfig

fn clone(&self) -> StackedConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StackedConfig

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

Formats the value using the given formatter.