mlua 项目使用教程

mlua 项目使用教程

mlua High level Lua 5.4/5.3/5.2/5.1 (including LuaJIT) and Roblox Luau bindings to Rust with async/await support 项目地址: https://gitcode.com/gh_mirrors/mlu/mlua

1. 项目介绍

mlua 是一个将 Lua 编程语言绑定到 Rust 的项目。它旨在提供一个安全、高级、易于使用、实用且灵活的 API。mlua 支持 Lua 5.4、5.3、5.2、5.1 版本以及 LuaJIT 和 Luau，使得可以在 Rust 中编写原生的 Lua 模块，同时也可以以独立模式使用 Lua。

2. 项目快速启动

环境准备

确保你的系统中已经安装了 Rust 编译工具链，包括 rustc（Rust 编译器）和 cargo（Rust 的包管理器）。

创建项目

创建一个新的 Rust 项目：

cargo new my_mlua_project
cd my_mlua_project

添加依赖

在 Cargo.toml 文件中添加 mlua 依赖，根据需要选择 Lua 的版本：

[dependencies]
mlua = { version = "0.10", features = ["lua54", "vendored"] }

这里选择了 Lua 5.4 版本，并且启用了 vendored 特性来内置 Lua 库。

编写代码

在 main.rs 文件中编写你的 Rust 代码，示例：

use mlua::prelude::*;

fn main() -> LuaResult<()> {
    let lua = Lua::new();
    let map_table = lua.create_table()?;
    map_table.set(1, "one")?;
    map_table.set("two", 2)?;
    lua.globals().set("map_table", map_table)?;
    lua.load("for k,v in pairs(map_table) do print(k,v) end")?.exec()?;

    Ok(())
}

构建项目

使用 cargo 构建你的项目：

cargo build

运行项目

构建成功后，运行你的项目：

cargo run

3. 应用案例和最佳实践

异步 HTTP 客户端

mlua 支持异步编程。下面是一个使用异步 HTTP 客户端的例子：

cargo run --example async_http_client --features=lua54,async,macros

HTTP 服务器

创建一个异步 HTTP 服务器的例子：

cargo run --example async_http_server --features=lua54,async,macros,send

然后可以使用 curl 访问：

curl -v http://localhost:3000

4. 典型生态项目

mlua 的生态系统中有许多项目，它们提供了各种功能，例如：

• mlua-sys：提供了与 Lua 系统交互的底层接口。
• mlua_derive：为 mlua 提供了 derive 宏，简化了类型转换。

开发者可以根据自己的需要选择合适的项目进行集成和使用。

mlua High level Lua 5.4/5.3/5.2/5.1 (including LuaJIT) and Roblox Luau bindings to Rust with async/await support 项目地址: https://gitcode.com/gh_mirrors/mlu/mlua