#sys #javascript #system #mozilla

sys mozjs_sys

System crate for the Mozilla SpiderMonkey JavaScript engine

11 unstable releases (4 breaking)

0.61.0 Aug 24, 2018
0.60.1 Aug 22, 2018
0.51.4 Jul 7, 2018
0.51.3 Jun 29, 2018
0.1.0 Nov 30, 2015

#18 in Encoding

Download history 204/week @ 2018-08-13 456/week @ 2018-08-20 524/week @ 2018-08-27 237/week @ 2018-09-03 328/week @ 2018-09-10 177/week @ 2018-09-17 226/week @ 2018-09-24 190/week @ 2018-10-01 198/week @ 2018-10-08 442/week @ 2018-10-15 474/week @ 2018-10-22 390/week @ 2018-10-29 586/week @ 2018-11-05

1,309 downloads per month
Used in 2 crates (1 directly)

MPL-2.0 license

53MB
1M SLoC

C++ 687K SLoC // 0.1% comments Python 263K SLoC // 0.1% comments C 176K SLoC // 0.2% comments Assembly 19K SLoC // 0.0% comments JavaScript 14K SLoC // 0.3% comments Shell 9K SLoC // 0.2% comments Rust 7K SLoC // 0.1% comments Perl 2K SLoC // 0.2% comments Java 1.5K SLoC // 0.2% comments Batch 1K SLoC // 0.0% comments Emacs Lisp 258 SLoC // 0.1% comments Objective C 242 SLoC // 0.3% comments VBScript 84 SLoC // 0.2% comments Objective C++ 73 SLoC // 0.1% comments R 12 SLoC // 0.6% comments D 8 SLoC // 0.7% comments Swift 7 SLoC

This repository contains Rust bindings for SpiderMonkey for use with Servo.

The bindings are to the raw SpiderMonkey API, higher-level bindings are in the rust-mozjs repository.

Building

Under Linux:

Install Clang (at least version 3.9), for example in a Debian-based Linux:

sudo apt-get install clang-6.0

If you have more than one version of Clang installed, you can set the LIBCLANG_PATH environment variable, for example:

export LIBCLANG_PATH=/usr/lib/clang/4.0/lib

Under Windows:

  1. Follow the directions at https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Windows_Prerequisites

  2. Open up a shell configured to use Visual Studio. This could be the one included with Visual Studio (e.g. Visual Studio 2017 / X64 Native Tools Command Prompt for VS 2017) or a shell in which you have run

"c:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
  1. Set the MOZTOOLS_PATH environment variable to point to the tools from the Mozilla Build Package:
set MOZTOOLS_PATH=C:\mozilla-build\msys\bin;C:\mozilla-build\mozmake;C:\mozilla-build\yasm
  1. Download and install Clang for Windows (64 bit) from https://releases.llvm.org/download.html and set the LIBCLANG_PATH environment variable to its lib directory:
set LIBCLANG_PATH=C:\Program Files\LLVM\lib
  1. Set environment variables so the build script can find Python 2.7 and Autoconf 2.13:
set AUTOCONF=C:\mozilla-build\msys\local\bin\autoconf-2.13
set NATIVE_WIN32_PYTHON=C:\mozilla-build\python\python2.7.exe

You can now build and test the crate using cargo:

cargo build
cargo test
cargo build --features debugmozjs
cargo test --features debugmozjs

Upgrading

In order to upgrade to a new version of SpiderMonkey:

  1. Find the mozilla-release commit for the desired version of SpiderMonkey, at https://treeherder.mozilla.org/#/jobs?repo=mozilla-release&filter-searchStr=spidermonkey%20pkg. You are looking for an SM(pkg) tagged with FIREFOX_RELEASE. Take a note of the commit number to the left (a hex number such as ac4fbb7aaca0).

  2. Click on the SM(pkg) link, which will open a panel with details of the commit, including an artefact uploaded link, with a name of the form mozjs-version.tar.bz2. Download it and save it locally.

  3. Look at the patches in etc/patches/*.patch, and remove any that no longer apply (with a bit of luck this will be all of them).

  4. Run python3 ./etc/update.py path/to/tarball.

  5. Update etc/COMMIT with the commit number.

  6. Build and test the bindings as above, then submit a PR!

Dependencies

~3MB
~59K SLoC

  • build build.rs
  • build bindgen 0.39
  • build cc 1.0