Rustler

文档 | 入门 | 示例

Rustler是一个库，用于在安全的Rust代码中编写Erlang NIF。这意味着你的Rust NIF代码不应该能够崩溃BEAM（Erlang虚拟机）。该库提供了与BEAM交互的模板代码生成功能，处理Erlang术语的编码和解码，并在它们回滚到C之前捕获rust恐慌。

该库为Erlang和Elixir提供了功能，但截至目前，Elixir更受欢迎。

功能

安全性：你编写的Rust NIF代码永远不会能够崩溃BEAM。

互操作性：将rust值解码和编码为Erlang术语就像调用一个函数一样简单。

类型组合：使用单个属性使Rust结构可编码和可解码到Erlang或Elixir。

资源对象：允许你安全地将Rust结构的引用传递到Erlang代码中。该结构将在不再被引用时自动删除。

入门

最简单的方法是使用rustler Elixir库。

• 将rustler Elixir库添加到你的项目的依赖项中。
• 运行mix rustler.new在项目中生成一个新的NIF。按照说明进行操作。
• 如果您已经在使用 serde 或之前使用过 serde_rustler，请确保在 NIF crate 的 Cargo.toml 文件中启用了 serde 功能，针对 rustler 依赖项。

它看起来像什么

这是添加两个数字并返回结果的极简 NIF 代码。

#[rustler::nif]
fn add(a: i64, b: i64) -> i64 {
    a + b
}

rustler::init!("Elixir.Math");

最低支持的 Rust 版本 (MSRV)

Rustler 目前最低支持的 Rust 版本 (MSRV) 为 1.70。这是在 .clippy.toml 中配置的版本。

支持的 OTP 和 Elixir 版本

Rustler 旨在支持最新的三个主要 OTP 版本以及最新的三个 Elixir 小版本。

支持的 NIF 版本

库应通过 Cargo 功能定义最低支持的 NIF 版本。默认值目前为 2.15（Erlang/OTP 22）。要使用 NIF 版本 2.16（Erlang/OTP 24）或 2.17（Erlang/OTP 26）的功能，必须在依赖项上启用相应的功能标志。

[dependencies]
rustler = { version = "...", features = ["nif_version_2_16"] }