use std::sync::Arc; use std::collections::HashMap; use parking_lot::RwLock; use elements::Module; use interpreter::{Error, UserError}; use interpreter::env::{self, env_module}; use interpreter::module::{ModuleInstance, ModuleInstanceInterface}; /// Program instance. Program is a set of instantiated modules. pub struct ProgramInstance { /// Shared data reference. essence: Arc>, } /// Program instance essence. pub struct ProgramInstanceEssence { /// Loaded modules. modules: RwLock>>>, } impl ProgramInstance where E: UserError { /// Create new program instance. pub fn new() -> Result> { ProgramInstance::with_env_params(env::EnvParams::default()) } /// Create new program instance with custom env module params (mostly memory) pub fn with_env_params(params: env::EnvParams) -> Result> { Ok(ProgramInstance { essence: Arc::new(ProgramInstanceEssence::with_env_params(params)?), }) } /// Create a new program instance with a custom env module pub fn with_env_module(env_module: Arc>) -> Self { ProgramInstance { essence: Arc::new(ProgramInstanceEssence::with_env_module(env_module)), } } /// Instantiate module with validation. pub fn add_module<'a>(&self, name: &str, module: Module, externals: Option<&'a HashMap + 'a>>>) -> Result>, Error> { let mut module_instance = ModuleInstance::new(Arc::downgrade(&self.essence), name.into(), module)?; module_instance.instantiate(externals)?; let module_instance = Arc::new(module_instance); self.essence.modules.write().insert(name.into(), module_instance.clone()); module_instance.run_start_function()?; Ok(module_instance) } /// Insert instantiated module. pub fn insert_loaded_module(&self, name: &str, module_instance: Arc>) -> Result>, Error> { // replace existing module with the same name with new one self.essence.modules.write().insert(name.into(), module_instance.clone()); Ok(module_instance) } /// Get one of the modules by name pub fn module(&self, name: &str) -> Option>> { self.essence.module(name) } } impl ProgramInstanceEssence where E: UserError { /// Create new program essence. pub fn new() -> Result> { ProgramInstanceEssence::with_env_params(env::EnvParams::default()) } pub fn with_env_params(env_params: env::EnvParams) -> Result> { let env_mod = env_module(env_params)?; Ok(ProgramInstanceEssence::with_env_module(Arc::new(env_mod))) } pub fn with_env_module(env_module: Arc>) -> Self { let mut modules = HashMap::new(); modules.insert("env".into(), env_module); ProgramInstanceEssence { modules: RwLock::new(modules), } } /// Get module reference. pub fn module(&self, name: &str) -> Option>> { self.modules.read().get(name).cloned() } }