25 releases

Uses old Rust 2015

0.67.1 Sep 24, 2019
0.61.13 May 4, 2019
0.61.12 Apr 25, 2019
0.61.8 Mar 25, 2019
0.1.0 Nov 30, 2015

#442 in Web programming

Download history 60/week @ 2022-06-15 66/week @ 2022-06-22 36/week @ 2022-06-29 55/week @ 2022-07-06 87/week @ 2022-07-13 51/week @ 2022-07-20 73/week @ 2022-07-27 89/week @ 2022-08-03 90/week @ 2022-08-10 38/week @ 2022-08-17 64/week @ 2022-08-24 48/week @ 2022-08-31 75/week @ 2022-09-07 69/week @ 2022-09-14 56/week @ 2022-09-21 70/week @ 2022-09-28

279 downloads per month
Used in 4 crates (via mozjs)

MPL-2.0 license

70MB
1.5M SLoC

C++ 710K SLoC // 0.1% comments Python 492K SLoC // 0.3% comments C 179K SLoC // 0.2% comments JavaScript 29K SLoC // 0.2% comments GNU Style Assembly 14K SLoC // 0.2% comments Shell 9K SLoC // 0.2% comments Rust 9K SLoC // 0.1% comments Visual Studio Project 7.5K SLoC // 0.0% comments Perl 2K SLoC // 0.2% comments Batch 1.5K SLoC // 0.0% comments INI 1K SLoC // 0.1% comments Visual Studio Solution 544 SLoC Automake 309 SLoC // 0.0% comments Emacs Lisp 258 SLoC // 0.1% comments Objective-C 242 SLoC // 0.3% comments Assembly 111 SLoC // 0.5% comments VBScript 84 SLoC // 0.2% comments Objective-C++ 73 SLoC // 0.1% comments RPM Specfile 38 SLoC PowerShell 34 SLoC // 0.8% 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) and autoconf v 2.13, for example in a Debian-based Linux:

sudo apt-get install clang-6.0 autoconf2.13

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\bin
  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

~2.6–4.5MB
~89K SLoC