Struct RestrictedModuleResolver 

pub struct RestrictedModuleResolver { /* private fields */ }

A resolver that can only load explicitly registered, logical module IDs.

It never reads the filesystem and rejects path traversal, absolute paths, platform path syntax, and cyclic imports.

Implementations

impl RestrictedModuleResolver

pub fn new() -> Self

pub fn from_source( source: &impl ScriptSource, ) -> Result<Self, ScriptSourceError>

Snapshot every module from a file or embedded script source.

Errors

Returns ScriptSourceError when any declared module cannot be loaded.

pub fn from_source_with_cache( source: &impl ScriptSource, cache: &ModuleCompileCache, ) -> Result<Self, ScriptSourceError>

Snapshot source while reusing transactionally compiled module ASTs.

Errors

Returns source errors for declared modules that cannot load.

pub fn insert( &mut self, id: impl Into<String>, source: impl Into<String>, ) -> Result<(), ModuleIdError>

Register source under a validated logical module identifier.

Errors

Returns ModuleIdError when id violates the resolver’s path rules.

pub fn contains(&self, id: &ModuleId) -> bool

Trait Implementations

impl Debug for RestrictedModuleResolver

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

Formats the value using the given formatter.

impl Default for RestrictedModuleResolver

fn default() -> Self

Returns the “default value” for a type.

impl ModuleResolver for RestrictedModuleResolver

fn resolve( &self, engine: &Engine, _source: Option<&str>, path: &str, position: Position, ) -> Result<Shared<Module>, Box<EvalAltResult>>

Resolve a module based on a path string.

fn resolve_raw( &self, engine: &Engine, global: &mut GlobalRuntimeState, scope: &mut Scope<'_>, path: &str, pos: Position, ) -> Result<Rc<Module>, Box<EvalAltResult>>

Resolve a module based on a path string, given a GlobalRuntimeState and the current Scope.

fn resolve_ast( &self, engine: &Engine, source: Option<&str>, path: &str, pos: Position, ) -> Option<Result<AST, Box<EvalAltResult>>>

Resolve an AST based on a path string.