Struct LuaEnv 

pub struct LuaEnv { /* private fields */ }

Unified Lua environment configuration.

Creates Lua VMs with consistent sandbox, orcs.* functions, and a unified require() that resolves modules from configured search paths (filesystem, sandbox-validated).

Implementations

impl LuaEnv

pub fn new(sandbox: Arc<dyn SandboxPolicy>) -> Self

Creates a new LuaEnv with the given sandbox policy.

pub fn with_search_path(self, path: impl AsRef<Path>) -> Self

Adds a search path for require() resolution.

Paths are searched in the order they are added. Each path is validated against the sandbox at require-time.

pub fn with_search_paths( self, paths: impl IntoIterator<Item = impl AsRef<Path>>, ) -> Self

Adds multiple search paths.

pub fn search_paths(&self) -> &[PathBuf]

Returns configured search paths.

pub fn create_lua(&self) -> Result<Lua, LuaError>

Creates a new sandboxed Lua VM.

The returned Lua VM has:

• orcs.* functions registered (log, exec, read, write, grep, glob, etc.)
• Dangerous Lua stdlib functions disabled
• Custom require() with sandbox-aware module resolution
• package.loaded cache for loaded modules

Errors

Returns error if VM setup fails.

Trait Implementations

impl Clone for LuaEnv

fn clone(&self) -> LuaEnv

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LuaEnv

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

Formats the value using the given formatter.