rustler 简单试用
昨天简单说了基于mrml 包装的elixir mjml_nif 模块,其中使用了rustler 进行elixir 与rust 的构建集成(基于了nif)
以下是一个简单的rustler 学习试用
项目准备
基于mix 初始化
- 初始化项目
mix new dalong
- 添加依赖
mix.exs
defp deps do
[
{:rustler, "~> 0.30.0"}
]
执行依赖更新
mix deps.get
- 初始化rust cargo native 项目
安装完rustler之后会包含一个mix 的task,可以进行初始化
mix rustler.new
按照提示操作,注意需要符合elixir 模块的命名
效果
生成的代码
native/dalong/src/lib.rs
#[rustler::nif]
fn add(a: i64, b: i64) -> i64 {
a + b
}
rustler::init!("Elixir.Dalong", [add]);
- 调用
建议先执行mix compile
lib/dalong.ex
defmodule Dalong do
use Rustler, otp_app: :dalong, crate: "dalong"
# When your NIF is loaded, it will override this function.
def add(_a, _b), do: :erlang.nif_error(:nif_not_loaded)
def hello do
:world
end
end
- 测试
iex -S mix
效果
说明
以上是一个简单的试用,实际上调用需要关注的东西还是比较多的,官方文档比较全,应该好好看看
参考资料
https://github.com/rusterlium/rustler
https://docs.rs/crate/rustler/latest
https://github.com/adoptoposs/mjml_nif
https://github.com/rusterlium/html5ever_elixir
https://github.com/rusterlium/NifIo