Struct PastaLuaRuntime 

pub struct PastaLuaRuntime { /* private fields */ }

Pasta Lua Runtime - hosts a Lua VM with pasta modules.

Each instance owns an independent Lua VM and SearchContext. Multiple instances can coexist without interference.

Implementations

impl PastaLuaRuntime

pub fn new(context: TranspileContext) -> LuaResult<Self>

Create a new runtime from a TranspileContext with default configuration.

Initializes a Lua VM with standard libraries enabled and registers:

• @pasta_search module with scene and word registries
• @assertions module for testing and validation
• @testing module for testing framework with hooks and reporting
• @regex module for regular expression support
• @json module for JSON encoding/decoding
• @yaml module for YAML encoding/decoding

Note: @env module is disabled by default for security reasons. Use RuntimeConfig::full() or enable it explicitly to access environment variables.

Arguments

• context - TranspileContext from LuaTranspiler::transpile()

Returns

• Ok(Self) - Runtime initialized successfully
• Err(e) - Lua VM or module registration failed

pub fn with_config( context: TranspileContext, config: RuntimeConfig, ) -> LuaResult<Self>

Create a new runtime from a TranspileContext with custom configuration.

Arguments

• context - TranspileContext from LuaTranspiler::transpile()
• config - Runtime configuration for library loading

Returns

• Ok(Self) - Runtime initialized successfully
• Err(e) - Lua VM or module registration failed

pub fn exec(&self, script: &str) -> LuaResult<Value>

Execute a Lua script string.

Arguments

• script - Lua code to execute

Returns

• Ok(Value) - Execution result
• Err(e) - Execution error

pub fn exec_file(&self, path: &Path) -> LuaResult<Value>

Execute a Lua script from a file.

Arguments

• path - Path to the Lua script file

Returns

• Ok(Value) - Execution result
• Err(e) - File read or execution error

pub fn lua(&self) -> &Lua

Get a reference to the internal Lua instance.

This allows advanced operations on the Lua VM.

pub fn logger(&self) -> Option<Arc<PastaLogger>>

Get a clone of the Arc-wrapped logger, if any.

This allows sharing the logger with GlobalLoggerRegistry for log routing in multi-instance scenarios.

pub fn config(&self) -> Option<&PastaConfig>

Get reference to PastaConfig if available.

Returns the configuration loaded from pasta.toml during PastaLoader::load().

Returns

• Some(&PastaConfig) - Config was set during load
• None - Config not available (e.g., runtime created without loader)

pub fn register_module(&self, name: &str, module: Table) -> LuaResult<()>

Register a custom module with the runtime.

Arguments

• name - Module name (e.g., “@my_module”)
• module - Module table

Returns

• Ok(()) - Module registered successfully
• Err(e) - Registration failed

pub fn from_loader( context: TranspileContext, loader_context: LoaderContext, config: RuntimeConfig, transpiled: &[TranspileResult], logger: Option<Arc<PastaLogger>>, ) -> LuaResult<Self>

Create a runtime from LoaderContext with transpiled code.

This is the factory method used by PastaLoader to create a runtime with all configuration applied.

Arguments

• context - TranspileContext with scene/word registries
• loader_context - Configuration and paths from PastaLoader
• config - Runtime configuration
• transpiled - Transpiled Lua code to load
• logger - Optional instance-specific logger (Arc-wrapped for sharing)

Returns

• Ok(Self) - Runtime initialized and code loaded
• Err(e) - Initialization or code loading failed

pub fn from_loader_with_scene_dic( context: TranspileContext, loader_context: LoaderContext, runtime_config: RuntimeConfig, pasta_config: Option<PastaConfig>, logger: Option<Arc<PastaLogger>>, _scene_dic_path: &Path, ) -> LuaResult<Self>

Create a runtime from LoaderContext with scene_dic.lua loading.

This is the new factory method used by PastaLoader with incremental transpilation. Instead of loading transpiled code directly, it loads scene_dic.lua which requires all cached scene modules.

Initialization Sequence (lua-module-path-resolution spec)

1. Setup package.path for module resolution
2. Register Rust modules (@pasta_config, @enc, @pasta_persistence, @pasta_sakura_script)
3. Register finalize_scene Rust binding
4. require(“main”) - User initialization (errors logged as warnings, continues)
5. require(“pasta.shiori.entry”) - SHIORI handlers (errors logged as warnings, continues)
6. require(“pasta.scene_dic”) - Scene loading and finalization

Arguments

• context - TranspileContext with scene/word registries
• loader_context - Configuration and paths from PastaLoader
• runtime_config - Runtime configuration
• pasta_config - Pasta configuration from pasta.toml
• logger - Optional instance-specific logger (Arc-wrapped for sharing)
• scene_dic_path - Path to the generated scene_dic.lua (used for backward compatibility check)

Returns

• Ok(Self) - Runtime initialized and scene_dic loaded
• Err(e) - Initialization or scene_dic loading failed

pub fn load_scene_dic(&self, scene_dic_path: &Path) -> LuaResult<()>

Load scene_dic.lua to initialize all scene modules.

This method requires the scene_dic.lua file which in turn requires all cached scene modules and calls finalize_scene().

Arguments

• scene_dic_path - Path to scene_dic.lua

Returns

• Ok(()) - All scenes loaded successfully
• Err(e) - Scene loading failed

Trait Implementations

impl Drop for PastaLuaRuntime

fn drop(&mut self)

Executes the destructor for this type.