Struct StandardLoader 

pub struct StandardLoader { /* private fields */ }

Standard loader for BarkML files with enhanced capabilities

This loader supports multiple methodologies for reading and combining BarkML files:

• Loading individual files with validation
• Loading directories of files with filtering
• Merging multiple files into a single module with conflict resolution
• Importing files as separate modules with namespace management
• Auto-discovering files in search paths with caching
• Performance monitoring and statistics collection
• Robust error handling and recovery

The loader can be configured through LoaderConfig to handle various scenarios and provides detailed statistics about the loading process.

Implementations

impl StandardLoader

pub fn new(config: LoaderConfig) -> Self

Creates a new StandardLoader with the specified configuration

pub fn builder() -> StandardLoaderBuilder

Creates a new StandardLoader with a builder pattern

pub fn stats(&self) -> &LoadStats

Gets the current loading statistics

pub fn clear_cache(&mut self)

Clears the file cache to free memory

pub fn cache_size(&self) -> usize

Gets the number of cached files

pub fn add_module<R>( &mut self, name: &str, code: &mut R, filename: Option<String>, ) -> Result<&mut Self, Error>

where R: Read + Seek,

Add a module with the given name to this loader with enhanced error handling

pub fn import<P>(&mut self, path: P) -> Result<&mut Self, Error>

where P: AsRef<Path>,

Add a single file to this loader as a new module with validation

pub fn add_file<P>(&mut self, path: P) -> Result<&mut Self, Error>

where P: AsRef<Path>,

Add a single file to this loader and merge it into the main module

pub fn import_dir<P>(&mut self, path: P) -> Result<&mut Self, Error>

where P: AsRef<Path>,

Add a directory to this loader and import all files as individual modules

pub fn add_dir<P>(&mut self, path: P) -> Result<&mut Self, Error>

where P: AsRef<Path>,

Add a directory to this loader and merge all files into the main module

pub fn main<P>( &mut self, name: &str, search_paths: Vec<P>, ) -> Result<&mut Self, Error>

where P: AsRef<Path>,

Load the main module with auto-discovery in search paths

pub fn module_names(&self) -> Vec<&String>

Gets all module names currently loaded

pub fn get_module(&self, name: &str) -> Option<&Statement>

Gets a specific module by name

pub fn has_module(&self, name: &str) -> bool

Checks if a module exists

pub fn remove_module(&mut self, name: &str) -> Option<Statement>

Removes a module by name

Trait Implementations

impl Default for StandardLoader

fn default() -> Self

Create a new loader with the default configuration

impl Loader for StandardLoader

fn is_resolution_enabled(&self) -> bool

Checks if macro resolution is enabled for this loader

fn skip_macro_resolution(&mut self) -> Result<&mut Self, Error>

Disables macro resolution for this loader

fn read(&self) -> Result<Statement, Error>

Reads all BarkML configuration files according to the loader’s configuration and returns the resulting module statement

fn load(&self) -> Result<Statement, Error>

Loads everything into a module statement and resolves macros if enabled

fn validate(&self) -> Result<(), Error>

Validates the loaded content without fully processing it