gecko-dev/js/rust
Tooru Fujisawa 126d74c714 Bug 1244280 - Use system stack limitation instead of hardcoded smaller value on linux. r=nbp
Great thanks to krzysztof.modras@gmail.com who initially wrote this patch.
2017-11-08 00:30:31 +09:00
..
etc
src Bug 1244280 - Use system stack limitation instead of hardcoded smaller value on linux. r=nbp 2017-11-08 00:30:31 +09:00
tests
.gitignore
CMakeLists.txt
Cargo.lock Bug 1414030 - Update the `bindgen` dependency for `js/rust`. r=emilio 2017-11-02 12:08:00 -04:00
Cargo.toml Bug 1414030 - Update the `bindgen` dependency for `js/rust`. r=emilio 2017-11-02 12:08:00 -04:00
README.md
build.rs Bug 1414030 - Update the `bindgen` dependency for `js/rust`. r=emilio 2017-11-02 12:08:00 -04:00

README.md

The js Crate: Rust Bindings to SpiderMonkey

User Documentation

Building

To build a release version of SpiderMonkey and the Rust code with optimizations enabled:

$ cargo build --release

To build with SpiderMonkey's DEBUG checks and assertions:

$ cargo build --features debugmozjs

Raw FFI bindings to JSAPI are machine generated with rust-lang-nursery/rust-bindgen, and requires libclang >= 3.9. See ./build.rs for details.

Cargo Features

  • debugmozjs: Create a DEBUG build of SpiderMonkey with many extra assertions enabled. This is decoupled from whether the crate and its Rust code is built in debug or release mode.

  • promises: Enable SpiderMonkey native promises.

  • nonzero: Leverage the unstable NonZero type. Requires nightly Rust.

Testing

Make sure to test both with and without the debugmozjs feature because various structures have different sizes and get passed through functions differently at the ABI level! At minimum, you should test with debugmozjs to get extra assertions and checking.

$ cargo test
$ cargo test --features debugmozjs