Struct Config 

pub struct Config {
    pub modules_path: Option<PathBuf>,
    pub max_call_depth: u32,
    pub max_module_repeat: u32,
    pub default_timeout_ms: u64,
    pub global_timeout_ms: u64,
    pub enable_tracing: bool,
    pub enable_metrics: bool,
    pub settings: HashMap<String, Value>,
    pub yaml_path: Option<PathBuf>,
    pub mode: ConfigMode,
}

Fields

modules_path: Option<PathBuf>

max_call_depth: u32

max_module_repeat: u32

default_timeout_ms: u64

global_timeout_ms: u64

enable_tracing: bool

enable_metrics: bool

settings: HashMap<String, Value>

yaml_path: Option<PathBuf>

mode: ConfigMode

Implementations

impl Config

pub fn from_json_file(path: &Path) -> Result<Self, ModuleError>

Load config from a JSON file, apply env overrides, and validate.

pub fn from_yaml_file(path: &Path) -> Result<Self, ModuleError>

Load config from a YAML file, apply env overrides, and validate.

pub fn load(path: &Path) -> Result<Self, ModuleError>

Auto-detect format by file extension and load.

pub fn validate(&self) -> Result<(), ModuleError>

Validate config constraints. Returns an error listing all violations.

pub fn from_defaults() -> Self

Build config from defaults, applying env var overrides.

pub fn discover() -> Result<Self, ModuleError>

Discover and load config using the §9.14 search order.

If no file is found, returns Config::from_defaults().

pub fn get(&self, key: &str) -> Option<Value>

Get a config value by dot-path key.

First checks typed fields (e.g. “executor.max_call_depth”), then falls back to the settings HashMap for arbitrary nested config.

pub fn set(&mut self, key: &str, value: Value)

Set a config value by dot-path key.

Attempts to set typed fields first, then falls back to the settings HashMap.

pub fn reload(&mut self) -> Result<(), ModuleError>

Reload config from the stored yaml_path. Returns error if no path stored.

pub fn data(&self) -> Value

Return a serde_json::Value representing the full config as a nested JSON object — typed fields merged on top of the settings map.

pub fn register_namespace(reg: NamespaceRegistration) -> Result<(), ModuleError>

pub fn env_map(mapping: HashMap<String, String>) -> Result<(), ModuleError>

Register global bare env var → top-level config key mappings.

pub fn registered_namespaces() -> Vec<NamespaceInfo>

pub fn namespace(&self, name: &str) -> Option<Value>

pub fn mount( &mut self, namespace: &str, source: MountSource, ) -> Result<(), ModuleError>

pub fn bind<T: DeserializeOwned>( &self, namespace: &str, ) -> Result<T, ModuleError>

pub fn get_typed<T: DeserializeOwned>( &self, key: &str, ) -> Result<T, ModuleError>

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.