154 breaking releases

Uses new Rust 2024

new 0.155.0 Dec 20, 2025
0.153.0 Dec 15, 2025
0.151.0 Oct 30, 2025
0.142.0 Jul 31, 2025
0.9.0 Nov 24, 2022

#1364 in Procedural macros

Download history 1149/week @ 2025-08-27 796/week @ 2025-09-03 1129/week @ 2025-09-10 1194/week @ 2025-09-17 1009/week @ 2025-09-24 1164/week @ 2025-10-01 1067/week @ 2025-10-08 1078/week @ 2025-10-15 1058/week @ 2025-10-22 741/week @ 2025-10-29 598/week @ 2025-11-05 896/week @ 2025-11-12 482/week @ 2025-11-19 553/week @ 2025-11-26 803/week @ 2025-12-03 574/week @ 2025-12-10

2,617 downloads per month
Used in 22 crates (7 directly)

MIT license

4KB

napi_sym

A proc_macro for Deno's Node-API implementation. It does the following things:

  • Marks the symbol as #[no_mangle] and rewrites it as unsafe extern "C" $name.
  • Asserts that the function symbol is present in symbol_exports.json.
  • Maps deno_napi::Result to raw napi_result.
use deno_napi::Env;
use deno_napi::Error;
use deno_napi::Result;
use deno_napi::napi_value;

#[napi_sym::napi_sym]
fn napi_get_boolean(
  env: *mut Env,
  value: bool,
  result: *mut napi_value,
) -> Result {
  let _env: &mut Env = env.as_mut().ok_or(Error::InvalidArg)?;
  // *result = ...
  Ok(())
}

symbol_exports.json

A file containing the symbols that need to be put into the executable's dynamic symbol table at link-time.

This is done using /DEF: on Windows, -exported_symbol,_ on macOS and --export-dynamic-symbol= on Linux. See cli/build.rs.

On Windows, you need to generate the .def file by running tools/napi/generate_symbols_lists.js.

Dependencies

~0.6–1.6MB
~34K SLoC