mlua-extras 0.0.5

Extra helpers and functionality built on top of mlua for embedded lua development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use mlua_extras::{
    extras::{LuaExtras, Require},
    mlua::{self, Function, Lua, Table, UserData, Value, Variadic},
};

struct MyModule;
impl UserData for MyModule {
    fn add_fields<'lua, F: mlua::prelude::LuaUserDataFields<'lua, Self>>(fields: &mut F) {
        fields.add_field("data", "Some Data");
    }

    fn add_methods<'lua, M: mlua::prelude::LuaUserDataMethods<'lua, Self>>(methods: &mut M) {
        methods.add_function("print", |_lua, values: Variadic<Value>| {
            println!(
                "{}",
                values
                    .iter()
                    .map(|v| v.to_string())
                    .collect::<mlua::Result<Vec<_>>>()?
                    .join(" ")
            );
            Ok(())
        });
    }
}

const CODE: &str = r#"data = {
    first = "key",
    second = "value"
}

print("KEYS: ", table.unpack(table.keys(data)))
print("VALUES: ", table.unpack(table.values(data)))

mymodule.print(mymodule.data)
"#;

fn main() -> mlua::Result<()> {
    let lua = Lua::new();

    // Get a value in a nested module/table (trait LuaExtras)
    let table = lua.require::<Table>("table")?;
    // Also works with regular tables (trait Require)
    let _unpack = table.require::<Function>("unpack")?;

    // Import a module into lua's global scope. This is just a UserData
    lua.set_global("mymodule", MyModule)?;

    {
        // Importing also works with tables given a lua context
        let temp = lua.create_table()?;
        temp.set("mymodule", MyModule)?;
    }

    if let Err(err) = lua.load(CODE).eval::<Value>() {
        eprintln!("{err}");
    }

    Ok(())
}