2020-09-25 04:59:21 +02:00
|
|
|
use crate::engine::Engine;
|
|
|
|
use crate::module::{Module, ModuleResolver};
|
|
|
|
use crate::result::EvalAltResult;
|
|
|
|
use crate::token::Position;
|
|
|
|
|
2020-10-07 09:40:36 +02:00
|
|
|
use crate::stdlib::{boxed::Box, ops::AddAssign, vec::Vec};
|
2020-09-25 04:59:21 +02:00
|
|
|
|
|
|
|
/// Module resolution service that holds a collection of module resolves,
|
|
|
|
/// to be searched in sequential order.
|
|
|
|
///
|
2020-10-27 04:30:38 +01:00
|
|
|
/// # Example
|
2020-09-25 04:59:21 +02:00
|
|
|
///
|
|
|
|
/// ```
|
|
|
|
/// use rhai::{Engine, Module};
|
|
|
|
/// use rhai::module_resolvers::{StaticModuleResolver, ModuleResolversCollection};
|
|
|
|
///
|
|
|
|
/// let mut collection = ModuleResolversCollection::new();
|
|
|
|
///
|
|
|
|
/// let resolver = StaticModuleResolver::new();
|
|
|
|
/// collection.push(resolver);
|
|
|
|
///
|
|
|
|
/// let mut engine = Engine::new();
|
|
|
|
/// engine.set_module_resolver(Some(collection));
|
|
|
|
/// ```
|
|
|
|
#[derive(Default)]
|
|
|
|
pub struct ModuleResolversCollection(Vec<Box<dyn ModuleResolver>>);
|
|
|
|
|
|
|
|
impl ModuleResolversCollection {
|
|
|
|
/// Create a new `ModuleResolversCollection`.
|
|
|
|
///
|
2020-10-27 04:30:38 +01:00
|
|
|
/// # Example
|
2020-09-25 04:59:21 +02:00
|
|
|
///
|
|
|
|
/// ```
|
|
|
|
/// use rhai::{Engine, Module};
|
|
|
|
/// use rhai::module_resolvers::{StaticModuleResolver, ModuleResolversCollection};
|
|
|
|
///
|
|
|
|
/// let mut collection = ModuleResolversCollection::new();
|
|
|
|
///
|
|
|
|
/// let resolver = StaticModuleResolver::new();
|
|
|
|
/// collection.push(resolver);
|
|
|
|
///
|
|
|
|
/// let mut engine = Engine::new();
|
|
|
|
/// engine.set_module_resolver(Some(collection));
|
|
|
|
/// ```
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-09-25 04:59:21 +02:00
|
|
|
pub fn new() -> Self {
|
|
|
|
Default::default()
|
|
|
|
}
|
|
|
|
/// Add a module keyed by its path.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-09-25 04:59:21 +02:00
|
|
|
pub fn push(&mut self, resolver: impl ModuleResolver + 'static) {
|
|
|
|
self.0.push(Box::new(resolver));
|
|
|
|
}
|
|
|
|
/// Get an iterator of all the module resolvers.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-09-25 04:59:21 +02:00
|
|
|
pub fn iter(&self) -> impl Iterator<Item = &dyn ModuleResolver> {
|
|
|
|
self.0.iter().map(|v| v.as_ref())
|
|
|
|
}
|
2020-10-07 09:40:36 +02:00
|
|
|
/// Get a mutable iterator of all the modules.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-10-07 09:40:36 +02:00
|
|
|
pub fn into_iter(self) -> impl Iterator<Item = Box<dyn ModuleResolver>> {
|
|
|
|
self.0.into_iter()
|
|
|
|
}
|
2020-09-25 04:59:21 +02:00
|
|
|
/// Remove all module resolvers.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-09-25 04:59:21 +02:00
|
|
|
pub fn clear(&mut self) {
|
|
|
|
self.0.clear();
|
|
|
|
}
|
2020-10-07 09:40:36 +02:00
|
|
|
/// Is this `ModuleResolversCollection` empty?
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-10-07 09:40:36 +02:00
|
|
|
pub fn is_empty(&self) -> bool {
|
|
|
|
self.0.is_empty()
|
|
|
|
}
|
|
|
|
/// Get the number of module resolvers in this `ModuleResolversCollection`.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-10-07 09:40:36 +02:00
|
|
|
pub fn len(&self) -> usize {
|
|
|
|
self.0.len()
|
|
|
|
}
|
|
|
|
/// Add another `ModuleResolversCollection` to the end of this collection.
|
|
|
|
/// The other `ModuleResolversCollection` is consumed.
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-10-07 09:40:36 +02:00
|
|
|
pub fn append(&mut self, other: Self) {
|
2020-10-27 04:30:38 +01:00
|
|
|
self.0.extend(other.0.into_iter());
|
2020-10-07 09:40:36 +02:00
|
|
|
}
|
2020-09-25 04:59:21 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
impl ModuleResolver for ModuleResolversCollection {
|
|
|
|
fn resolve(
|
|
|
|
&self,
|
|
|
|
engine: &Engine,
|
|
|
|
path: &str,
|
|
|
|
pos: Position,
|
|
|
|
) -> Result<Module, Box<EvalAltResult>> {
|
|
|
|
for resolver in self.0.iter() {
|
2020-09-28 05:19:49 +02:00
|
|
|
match resolver.resolve(engine, path, pos) {
|
|
|
|
Ok(module) => return Ok(module),
|
|
|
|
Err(err) => match *err {
|
|
|
|
EvalAltResult::ErrorModuleNotFound(_, _) => continue,
|
|
|
|
EvalAltResult::ErrorInModule(_, err, _) => return Err(err),
|
|
|
|
_ => panic!("ModuleResolver::resolve returns error that is not ErrorModuleNotFound or ErrorInModule"),
|
|
|
|
},
|
2020-09-25 04:59:21 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
EvalAltResult::ErrorModuleNotFound(path.into(), pos).into()
|
|
|
|
}
|
|
|
|
}
|
2020-10-07 09:40:36 +02:00
|
|
|
|
|
|
|
impl<M: ModuleResolver + 'static> AddAssign<M> for ModuleResolversCollection {
|
2020-10-08 16:25:50 +02:00
|
|
|
#[inline(always)]
|
2020-10-07 09:40:36 +02:00
|
|
|
fn add_assign(&mut self, rhs: M) {
|
|
|
|
self.push(rhs);
|
|
|
|
}
|
|
|
|
}
|