Struct LuaEngine 

pub struct LuaEngine { /* private fields */ }

A sandboxed Lua execution environment.

The engine provides access to mdvault functionality through the mdv global table while restricting dangerous operations like file I/O and shell execution.

Example

use mdvault_core::scripting::LuaEngine;

let engine = LuaEngine::sandboxed().unwrap();
let result = engine.eval_string(r#"mdv.date("today + 7d")"#).unwrap();
println!("One week from now: {}", result);

Implementations

impl LuaEngine

pub fn new(config: SandboxConfig) -> Result<Self, ScriptingError>

Create a new Lua engine with the given sandbox configuration.

pub fn sandboxed() -> Result<Self, ScriptingError>

Create a new engine with default restrictive sandbox.

pub fn with_vault_context( config: SandboxConfig, vault_ctx: VaultContext, ) -> Result<Self, ScriptingError>

Create a new Lua engine with vault context for hook execution.

This provides access to mdv.template(), mdv.capture(), mdv.macro() and index query functions in addition to the standard sandboxed bindings.

Example

use mdvault_core::scripting::{LuaEngine, VaultContext, SandboxConfig};

let vault_ctx = VaultContext::new(config, templates, captures, macros, types);
let engine = LuaEngine::with_vault_context(SandboxConfig::restricted(), vault_ctx)?;

// Now Lua scripts can use vault operations
engine.eval_string(r#"
    local ok, err = mdv.capture("log-to-daily", { text = "Hello" })
"#)?;

// And query the index (if available)
engine.eval_string(r#"
    local tasks = mdv.query({ type = "task" })
"#)?;

pub fn eval(&self, script: &str) -> Result<Option<String>, ScriptingError>

Execute a Lua script and return the result.

Returns None if the script returns nil or no value.

pub fn eval_string(&self, script: &str) -> Result<String, ScriptingError>

Execute a Lua script that must return a string value.

Returns an error if the script returns nil.

pub fn eval_bool(&self, script: &str) -> Result<bool, ScriptingError>

Execute a Lua script that returns a boolean.

pub fn lua(&self) -> &Lua

Get a reference to the underlying Lua state (for advanced usage).

Trait Implementations

impl Default for LuaEngine

fn default() -> Self

Returns the “default value” for a type.