nodejs 0.2.2

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

# rust-nodejs

[![Test](https://github.com/patr0nus/rust-nodejs/actions/workflows/test.yml/badge.svg)](https://github.com/patr0nus/rust-nodejs/actions/workflows/test.yml)
[![Clippy Check](https://github.com/patr0nus/rust-nodejs/actions/workflows/clippy.yml/badge.svg)](https://github.com/patr0nus/rust-nodejs/actions/workflows/clippy.yml)

Embedding Node.js in Rust.  

- Queue tasks to the Node.js event loop thread-safely.
- 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.

## Guide

1. Copy the [.cargo](https://github.com/patr0nus/rust-nodejs/tree/master/.cargo) folder in this repo to your cargo project to enable flags required to link Node.js properly. 
2. `let channel = nodejs::channel()` to get the global Node.js channel.
3. Call `channel.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.9.0/neon/index.html)

## Example
```rust
fn main() {
    let (tx, rx) = std::sync::mpsc::sync_channel::<String>(0);
    let channel = nodejs::channel();
    channel.send(move |mut cx| {
        use nodejs::neon::{context::Context, reflect::eval, types::JsString};
        let script = cx.string("require('http').STATUS_CODES[418]");
        let whoami = eval(&mut cx, script)?;
        let whoami = whoami.downcast_or_throw::<JsString, _>(&mut cx)?;
        tx.send(whoami.value(&mut cx)).unwrap();
        Ok(())
    });
    let whoami = rx.recv().unwrap();
    assert_eq!(whoami, "I'm a Teapot");
}
```