Struct AgentConfigs 

pub struct AgentConfigs(/* private fields */);

Configuration container for an agent.

Holds configuration values in key-value format and provides type-safe accessor methods. Configuration parameters defined with #[modular_agent] macro are stored in this struct.

Implementations

impl AgentConfigs

pub fn new() -> Self

Creates a new empty configuration container.

pub fn set(&mut self, key: String, value: AgentValue)

Sets a configuration value.

pub fn contains_key(&self, key: &str) -> bool

Returns true if the configuration contains the specified key.

pub fn get(&self, key: &str) -> Result<&AgentValue, AgentError>

Gets a configuration value by key.

Errors

Returns UnknownConfig if the key does not exist.

pub fn get_bool(&self, key: &str) -> Result<bool, AgentError>

Gets a boolean configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to boolean.

pub fn get_bool_or(&self, key: &str, default: bool) -> bool

Gets a boolean configuration value, or the specified default if not found.

pub fn get_bool_or_default(&self, key: &str) -> bool

Gets a boolean configuration value, or false if not found.

pub fn get_integer(&self, key: &str) -> Result<i64, AgentError>

Gets an integer configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to integer.

pub fn get_integer_or(&self, key: &str, default: i64) -> i64

Gets an integer configuration value, or the specified default if not found.

pub fn get_integer_or_default(&self, key: &str) -> i64

Gets an integer configuration value, or 0 if not found.

pub fn get_number(&self, key: &str) -> Result<f64, AgentError>

Gets a number (f64) configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to number.

pub fn get_number_or(&self, key: &str, default: f64) -> f64

Gets a number configuration value, or the specified default if not found.

pub fn get_number_or_default(&self, key: &str) -> f64

Gets a number configuration value, or 0.0 if not found.

pub fn get_string(&self, key: &str) -> Result<String, AgentError>

Gets a string configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to string.

pub fn get_string_or(&self, key: &str, default: impl Into<String>) -> String

Gets a string configuration value, or the specified default if not found.

pub fn get_string_or_default(&self, key: &str) -> String

Gets a string configuration value, or an empty string if not found.

pub fn get_array(&self, key: &str) -> Result<&Vector<AgentValue>, AgentError>

Gets an array configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to array.

pub fn get_array_or<'a>( &'a self, key: &str, default: &'a Vector<AgentValue>, ) -> &'a Vector<AgentValue>

Gets an array configuration value, or the specified default if not found.

pub fn get_array_or_default(&self, key: &str) -> Vector<AgentValue>

Gets an array configuration value, or an empty array if not found.

pub fn get_object( &self, key: &str, ) -> Result<&AgentValueMap<String, AgentValue>, AgentError>

Gets an object configuration value.

Errors

Returns UnknownConfig if the key does not exist or cannot be converted to object.

pub fn get_object_or<'a>( &'a self, key: &str, default: &'a AgentValueMap<String, AgentValue>, ) -> &'a AgentValueMap<String, AgentValue>

Gets an object configuration value, or the specified default if not found.

pub fn get_object_or_default( &self, key: &str, ) -> AgentValueMap<String, AgentValue>

Gets an object configuration value, or an empty object if not found.

pub fn keys(&self) -> Keys<'_, String, AgentValue>

Returns an iterator over the configuration keys.

pub fn remove(&mut self, key: &str) -> Option<AgentValue>

Removes a configuration value by key, returning the value if it existed.

Uses shift_remove to preserve insertion order.

pub fn retain<F>(&mut self, f: F)

where F: FnMut(&String, &mut AgentValue) -> bool,

Retains only the configuration entries for which the predicate returns true.

Trait Implementations

impl Clone for AgentConfigs

fn clone(&self) -> AgentConfigs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentConfigs

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

Formats the value using the given formatter.

impl Default for AgentConfigs

fn default() -> AgentConfigs

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AgentConfigs

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> FromIterator<(&'a String, &'a AgentValue)> for AgentConfigs

fn from_iter<T: IntoIterator<Item = (&'a String, &'a AgentValue)>>( iter: T, ) -> Self

Creates a value from an iterator.

impl FromIterator<(String, AgentValue)> for AgentConfigs

fn from_iter<T: IntoIterator<Item = (String, AgentValue)>>(iter: T) -> Self

Creates a value from an iterator.

impl<'a> IntoIterator for &'a AgentConfigs

type Item = (&'a String, &'a AgentValue)

The type of the elements being iterated over.

type IntoIter = Iter<'a, String, AgentValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for AgentConfigs

type Item = (String, AgentValue)

The type of the elements being iterated over.

type IntoIter = IntoIter<String, AgentValue>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Serialize for AgentConfigs

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

where __S: Serializer,

Serialize this value into the given Serde serializer.