Struct LuaEngine 

pub struct LuaEngine { /* private fields */ }

The Lua scripting engine. Thread-safe, cheaply cloneable.

Holds a pool of pre-initialized Lua states (one per worker) for global scripts, plus per-script pools for route-specific scripts.

Implementations

impl LuaEngine

pub fn new( scripts_dir: &Path, num_states: usize, hook_timeout: Duration, ) -> Result<Self>

Create a new LuaEngine by loading all .lua files from scripts_dir.

num_states should match the number of worker threads. hook_timeout is the max execution time per hook call.

pub fn with_route_scripts( scripts_dir: &Path, num_states: usize, hook_timeout: Duration, global_scripts: &[String], route_script_names: &[String], ) -> Result<Self>

Create a LuaEngine with per-route script support.

global_scripts — filenames loaded into the global pool (run on every request) route_script_names — unique filenames that need their own per-worker pools

pub fn has_on_request(&self) -> bool

pub fn has_on_route(&self) -> bool

pub fn has_on_response(&self) -> bool

pub fn has_on_request_end(&self) -> bool

pub fn call_on_request(&self, req: &mut LuaRequest) -> RequestHookResult

Call on_request(req). Returns Continue or Deny.

pub fn call_route_on_request( &self, script_name: &str, req: &mut LuaRequest, ) -> RequestHookResult

Call on_request for a specific route script. Returns Continue or Deny.

pub fn call_on_route( &self, req: &LuaRequest, matched_target: &str, ) -> RouteHookResult

Call on_route(req, matched_target). Returns Override(url) or Default.

pub fn call_route_on_route( &self, script_name: &str, req: &LuaRequest, matched_target: &str, ) -> RouteHookResult

Call on_route for a specific route script.

pub fn call_on_response( &self, req: &LuaRequest, status: u16, headers: &HashMap<String, String>, ) -> ResponseMod

Call on_response(req, resp). Returns ResponseMod with any changes.

pub fn call_route_on_response( &self, script_name: &str, req: &LuaRequest, status: u16, headers: &HashMap<String, String>, ) -> ResponseMod

Call on_response for a specific route script.

pub fn call_on_request_end( &self, req: &LuaRequest, status: u16, duration_ms: f64, target: &str, )

Call on_request_end(req, resp_status, duration_ms).

pub fn call_route_on_request_end( &self, script_name: &str, req: &LuaRequest, status: u16, duration_ms: f64, target: &str, )

Call on_request_end for a specific route script.

pub fn has_route_script(&self, name: &str) -> bool

Check if a route script is loaded.

Trait Implementations

impl Clone for LuaEngine

fn clone(&self) -> LuaEngine

Returns a duplicate of the value.

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

Performs copy-assignment from source.