Struct AAML 

pub struct AAML { /* private fields */ }

👎Deprecated since 2.0.0:

please use AAM and Pipeline instead

The main AAML parser and configuration store.

Holds a flat key-value map, registered type definitions, command handlers, and schema definitions. All directives (@derive, @schema, etc.) are processed at parse time.

Example

use aam_core::aaml::AAML;

let cfg = AAML::parse("host = localhost\nport = 8080").unwrap();
assert_eq!(cfg.find_obj("host").unwrap().as_str(), "localhost");

Implementations

impl AAML

pub fn find_obj(&self, key: &str) -> Option<FoundValue>

Looks up key in the map. If not found as a key, performs a reverse lookup — searching for an entry whose value matches key.

pub fn find_key(&self, value: &str) -> Option<FoundValue>

Reverse lookup: finds the key whose value equals value.

pub fn find_deep(&self, key: &str) -> Option<FoundValue>

Follows a chain of key -> value -> key lookups until a terminal value is reached or a cycle is detected.

impl AAML

pub fn validate_schemas_completeness(&self) -> Result<(), AamlError>

Checks every required field in every registered schema against the current map. Optional fields (declared with *) are skipped.

pub fn validate_schemas_completeness_for( &self, schema_names: &[&str], ) -> Result<(), AamlError>

Checks required fields only for the named schemas. Used by @derive to validate only child-defined schemas, not inherited ones.

pub fn apply_schema( &self, schema_name: &str, data: &HashMap<String, String>, ) -> Result<(), AamlError>

Validates a complete data map against the named schema.

For every required field declared in the schema the method checks:

1. The key is present in data.
2. The value satisfies the declared type (including nested schemas and lists).

Optional fields (declared with *) are only validated when they are present in data; their absence is not an error.

impl AAML

pub fn new() -> Self

Creates a new empty AAML instance with all default commands registered.

pub const fn get_schemas(&self) -> &HashMap<String, SchemaDef>

pub fn with_capacity(capacity: usize) -> Self

Creates a new AAML instance pre-allocated for capacity key-value entries.

pub fn get_schema(&self, name: &str) -> Option<&SchemaDef>

pub fn register_command<C: Command + 'static>(&mut self, command: C)

Registers a custom command handler.

pub fn register_type<T: Type + 'static>(&mut self, name: String, type_def: T)

Registers a named type definition for use in schema field validation.

pub fn get_type(&self, name: &str) -> Option<&dyn Type>

Returns the type handler registered under name, or None.

pub fn unregister_type(&mut self, name: &str)

Removes the type registered under name.

pub fn check_type(&self, type_name: &str, value: &str) -> Result<(), AamlError>

Validates value against a type registered under type_name.

Errors

Returns AamlError if the type is not found or validation fails.

pub fn validate_value( &self, type_name: &str, value: &str, ) -> Result<(), AamlError>

Validates value against the type registered as type_name, also resolving built-in primitive types and module paths.

Errors

Returns AamlError if the type is not found or validation fails.

pub fn merge_content(&mut self, content: &str) -> Result<(), AamlError>

Parses AAML content from a string, merging it into this instance.

Errors

Returns AamlError if parsing fails (e.g., syntax errors, IO errors).

pub fn merge_file<P: AsRef<Path>>( &mut self, file_path: P, ) -> Result<(), AamlError>

Reads a file from the disk and merges its content into this instance.

pub fn parse(content: &str) -> Result<Self, AamlError>

Parses an AAML string and returns a new AAML instance.

pub fn load<P: AsRef<Path>>(file_path: P) -> Result<Self, AamlError>

Loads an AAML file from the disk and returthe ns a new AAML instance.

pub fn unwrap_quotes(s: &str) -> &str

Strips surrounding "…" or '…' quotes. Returns the trimmed string unchanged if it is not quoted.

pub fn import_schema( &mut self, name: &str, source: &mut Self, ) -> Result<(), AamlError>

pub fn merge_map_weak( &mut self, other_map: &mut HashMap<Box<str>, Box<str>, RandomState>, )

pub fn keys(&self) -> Vec<&str>

Returns all keys currently stored in the map.

pub fn to_map(&self) -> HashMap<String, String>

Returns all key-value pairs as a HashMap<String, String>.

Trait Implementations

impl Add for AAML

Available on crate feature legacy only.

type Output = AAML

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl AddAssign for AAML

Available on crate feature legacy only.

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Debug for AAML

Available on crate feature legacy only.

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

Formats the value using the given formatter.

impl Default for AAML

Available on crate feature legacy only.

fn default() -> Self

Returns the “default value” for a type.