deno_bindgen

此工具旨在简化使用Rust编写的Deno FFI库的粘合代码生成。

安装

通过cargo命令行安装

cargo install deno_bindgen_cli

用法

use deno_bindgen::deno_bindgen;

// Export `add` function to JavaScript.
#[deno_bindgen]
fn add(a: u32, b: u32) -> u32 {
    a + b
}

直接在ESM中使用TypeScript类型声明使用导出的函数

import { add } from "./bindings/mod.ts";

add(1, 2);

设计

该工具设计用于非常容易地编写高性能的FFI绑定。在0.10中进行了许多重新设计，以防止性能陷阱。

自动生成并支持TypeScript类型。

所有类句柄都支持通过显式资源管理API（using）释放内存。

#[deno_bindgen]
pub struct Foo;

#[deno_bindgen]
impl Foo {
  #[constructor]
  pub fn new() -> Self {
    Self
  }

  pub fn bar(&self) {
    // ...
  }
}

import { Foo } from "@ffi/example";

{
  using foo = new Foo();
  foo.bar();
  // foo is disposed here...
}

高性能。代码生成尝试为所有绑定采取最快的可能路径，就好像它们是手动编写的，以充分利用Deno FFI JIT调用的功能。

> make bench
cpu: Apple M1
runtime: deno 1.38.0 (aarch64-apple-darwin)

file:///Users/divy/gh/deno_bindgen/example/bench.js
benchmark      time (avg)        iter/s             (min … max)       p75       p99      p995
--------------------------------------------------------------- -----------------------------
add             6.88 ns/iter 145,297,626.6    (6.78 ns … 13.33 ns)   6.81 ns   8.22 ns    9.4 ns
bytelen         8.05 ns/iter 124,278,976.3     (7.81 ns … 18.1 ns)   8.09 ns  10.39 ns  11.64 ns

发布

默认情况下，deno_bindgen为本地开发生成绑定。要发布跨平台绑定，可以使用--lazy-init标志，这使您可以完全控制如何托管预构建的共享库并在运行时拉取它们。

deno_bindgen --release --lazy-init

import { add, load } from "./example/mod.ts";
import { cache } from "https://docs.deno.org.cn/x/cache/mod.ts";

// Download the shared library from a CDN
const file = await cache("https://example.com/example.so");
load(file.path);

add(1, 2);