docs.rs failed to build lua-bind-0.1.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

Lua-Bind - Rust与Lua的无缝绑定库

一个高性能、线程安全的Rust到Lua的绑定系统，提供自动类型注册和依赖注入功能。

功能特性

🚀 自动类型注册 - 通过宏自动将Rust类型暴露给Lua
🔒 线程安全 - 内置线程安全的Lua状态管理
⚡ 高性能 - 零成本抽象，最小化运行时开销
🔄 双向交互 - 支持双向调用(Rust→Lua和Lua→Rust)
📦 模块化设计 - 可扩展的架构设计

安装

在Cargo.toml中添加：

[dependencies]

lua-bind = { version = "0.1", features = ["async"] }  # 按需启用特性

可选特性：

async - 启用异步支持
vendored - 静态链接Lua库

快速开始

基本类型绑定

use lua_bind::{get_lua, register_binding};

#[derive(Default)]
struct MathUtils;

impl mlua::UserData for MathUtils {
    fn add_methods<'lua, M: mlua::UserDataMethods<'lua, Self>>(methods: &mut M) {
        methods.add_method("add", |_, _, (a, b): (i32, i32)| Ok(a + b));
    }
}

register_binding!(MathUtils);

fn main() {
    let lua = get_lua().unwrap();
    lua.load(r#"
        print(Rust.MathUtils.add(1, 2))  -- 输出3
    "#).exec().unwrap();
}

异步支持

#[derive(Default)]
struct AsyncApi;

impl mlua::UserData for AsyncApi {
    fn add_methods<'lua, M: mlua::UserDataMethods<'lua, Self>>(methods: &mut M) {
        methods.add_async_method("fetch", |_, _, url: String| async {
            Ok(reqwest::get(&url).await?.text().await?)
        });
    }
}

进阶用法

序列化支持

#[derive(Serialize, Deserialize)]
struct User {
    name: String,
    age: u32
}

impl mlua::UserData for User {
    fn add_methods<'lua, M: mlua::UserDataMethods<'lua, Self>>(methods: &mut M) {
        methods.add_method("to_json", |_, this, ()| {
            Ok(serde_json::to_string(this)?)
        });
    }
}

多线程安全

let handles: Vec<_> = (0..4).map(|_| {
    thread::spawn(|| {
        let lua = get_lua().unwrap();
        // 安全并发访问
    })
}).collect();

API参考

完整API文档见: docs.rs/lua-bind

示例代码

查看examples/目录获取更多示例：

basic.rs - 基础用法
async.rs - 异步交互
serialization.rs - 序列化示例

运行示例

cargo run --example basic

cargo run --example async --features test-async

cargo run --example serialization

test-async 只为了适配async案例设计的特性，不建议直接使用

贡献指南

欢迎提交Issue和PR！开发前请阅读：

运行测试：cargo test --all-features
检查格式：cargo fmt --all
更新文档和CHANGELOG

许可证

本项目采用双重许可：

MIT许可证（见LICENSE）
Apache-2.0许可证（见LICENSE）

lua-bind 0.1.0