Struct RuleBasedLoader 

pub struct RuleBasedLoader { /* private fields */ }

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Configuration loader with rule-based discovery.

Provides advanced configuration loading with support for:

• Rule-based file discovery
• Multi-tier configuration merging
• Fragment (conf.d) loading
• Custom merge strategies

Example

use cfgmatic_files::RuleBasedLoader;
use cfgmatic_paths::{ConfigRuleSet, ConfigFileRule, TierSearchMode};
use cfgmatic_merge::MergeBehavior;

let rules = ConfigRuleSet::builder()
    .main_file(ConfigFileRule::toml("config")
        .tiers(TierSearchMode::All)
        .required(true))
    .build();

let loader = RuleBasedLoader::new("myapp")
    .rules(rules)
    .merge_behavior(MergeBehavior::Deep);

// Load with discovery info
match loader.load_with_discovery::<serde_json::Value>() {
    Ok((config, discovery)) => {
        println!("Loaded from {} files", discovery.file_count());
    }
    Err(e) => eprintln!("Error: {}", e),
}

Implementations

impl RuleBasedLoader

pub fn new(app_name: impl Into<String>) -> Self

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Create a new loader for an application.

pub fn rules(self, rules: ConfigRuleSet) -> Self

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Set the rule set for file discovery.

pub fn merge_behavior(self, behavior: MergeBehavior) -> Self

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Set the merge behavior.

pub const fn array_strategy(self, strategy: ArrayMergeStrategy) -> Self

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Set the array merge strategy.

pub const fn merge_options(self, options: MergeOptions) -> Self

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Set full merge options.

pub fn load_with_discovery<T>(&self) -> Result<(T, RuleBasedDiscovery)>

where T: DeserializeOwned + Merge + Default,

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Load configuration with discovery information.

Errors

Returns an error if:

• Required files are not found
• Files cannot be read or parsed
• Merge fails in Error mode with conflicts

Example

use cfgmatic_files::RuleBasedLoader;

let loader = RuleBasedLoader::new("myapp");
match loader.load_with_discovery::<serde_json::Value>() {
    Ok((config, discovery)) => {
        println!("Loaded config: {:#}", config);
        for path in discovery.all_paths() {
            println!("  - {}", path.display());
        }
    }
    Err(e) => eprintln!("Error: {}", e),
}

pub fn load<T>(&self) -> Result<T>

where T: DeserializeOwned + Merge + Default,

👎Deprecated since 2.0.1: use cfgmatic-source crate instead, which provides a unified configuration source API

Load configuration (without discovery info).

Errors

Returns an error if configuration cannot be loaded.

Trait Implementations

impl Clone for RuleBasedLoader

fn clone(&self) -> RuleBasedLoader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuleBasedLoader

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

Formats the value using the given formatter.