Note: This is an Lua 5.5 lib through AI-assisted programming.

luars is a pure Rust Lua 5.5 runtime and embedding toolkit. This repository contains the core library, derive macros, the interpreter, debugger integration, a WASM target, and several host-facing examples.

The repository-level documentation is intentionally focused on the high-level Lua API. Lower-level LuaVM APIs still exist, but the default examples and guides now use the high-level surface first.

[dependencies]
luars = "0.18"

use luars::{Lua, SafeOption, Stdlib};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut lua = Lua::new(SafeOption::default());
    lua.load_stdlibs(Stdlib::All)?;

    lua.register_function("add", |a: i64, b: i64| a + b)?;
    let sum: i64 = lua.load("return add(20, 22)").eval()?;

    assert_eq!(sum, 42);
    Ok(())
}

• Execute chunks with lua.load(...).exec(), eval(), and eval_multi()
• Execute async chunks with exec_async(), eval_async(), and eval_multi_async()
• Call Lua globals with call_global() / call_global1() and their async variants
• Register Rust functions with register_function() and register_async_function()
• Expose Rust types with register_type() and LuaUserData
• Work with globals and tables through globals(), create_table(), and create_table_from()
• Create scoped borrowed callbacks and userdata through scope(...)
• Run isolated chunks through load_sandboxed() and execute_sandboxed() when the sandbox feature is enabled

cargo test

MIT. See LICENSE.