nodejs 0.1.1

Embedding Node.js in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# rust-nodejs

Embedding Node.js in Rust.  

- Provide a global thread-safe Node.js event queue.
- Interact with the Node.js runtime via [Neon](https://neon-bindings.com) API.
- Link with [prebuilt Node.js binaries](https://github.com/patr0nus/libnode/) to save compile time.
- Native modules are supported.

## Usage

1. Add rust-nodejs to your cargo project:
```toml
[dependencies]
nodejs = "0.1.1"
```
2. `let queue = nodejs::event_queue()` to get the global Node.js event queue.
3. Call `queue.send` to run tasks in the Node.js event queue
4. Inside the task, use `nodejs::neon` for interoperability between Node.js and Rust. [Neon documentation](https://docs.rs/neon/0.8.0-napi/neon/index.html)
5. On macOS or Linux, add `-Clink-args=-rdynamic` to `rustflags` when building your Rust application.

## Example
```rust
use nodejs::neon::{context::Context, types::JsNumber, reflect::eval};

fn main() {
    let (tx, rx) = std::sync::mpsc::sync_channel::<i64>(0);
    let queue = nodejs::event_queue();
    queue.send(move |mut cx| {
        let script = cx.string("require('os').freemem()");
        let free_mem = eval(&mut cx, script)?;
        let free_mem = free_mem.downcast_or_throw::<JsNumber, _>(&mut cx)?;
        tx.send(free_mem.value(&mut cx) as i64).unwrap();
        Ok(())
    });
    let free_mem = rx.recv().unwrap();
    println!("Free system memory: {}", free_mem);
}

```