Rust bindings for writing safe and fast native Node.js modules.
Once you have the platform dependencies installed, getting started is as simple as:
$ npm install -g neon-cli
$ neon new my-project
See the Getting Started guide for details.
| Linux | macOS | Windows |
|---|---|---|
| ✓ | ✓ | ✓ |
| Node 4 | Node 6 | Node 7 | Node 8 |
|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ |
Support for LTS versions of Node and current are expected. If you're using a different version of Node and believe it should be supported, let us know.
Neon supports Rust stable version 1.18 and higher. We test on the latest stable, beta, and nightly versions of Rust.
A Neon function takes a Call object and produces a Rust Result that's either a JS value or the Throw constant (meaning a JS exception was thrown). The Call object provides access to a memory management scope, which safely manages the rooting of handles to heap objects:
fn make_an_array(call: Call) -> JsResult<JsArray> {
let scope = call.scope; // the current scope for rooting handles
let array: Handle<JsArray> = JsArray::new(scope, 3);
array.set(0, JsInteger::new(scope, 9000))?;
array.set(1, JsInteger::new(scope))?;
array.set(2, JsNumber::new(scope, 3.14159))?;
Ok(array)
}To learn more, check out the Neon guides.
The Neon community is just getting started and there's tons of fun to be had. Come play! :)
The Rust Bindings community Slack is open to all; use the Slackin app to receive an invitation.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.