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 |
#1569 in Web programming
106 downloads per month
Used in 4 crates
(via mozjs)
74MB
1.5M
SLoC
Contains (Python package, 1.5MB) pip-9.0.3-py2.py3-none-any.whl, (Python package, 570KB) setuptools-39.0.1-py2.py3-none-any.whl, (Python package, 485KB) setuptools-36.8.0-py2.py3-none-any.whl, (DOS exe, 90KB) t32.exe, (DOS exe, 98KB) t64.exe, (DOS exe, 86KB) w32.exe and 21 more.
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:
-
Follow the directions at https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Build_Instructions/Windows_Prerequisites
-
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"
- 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
- Download and install Clang for Windows (64 bit) from https://releases.llvm.org/download.html
and set the
LIBCLANG_PATH
environment variable to itslib
directory:
set LIBCLANG_PATH=C:\Program Files\LLVM\lib
- 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:
-
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).
-
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.
-
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). -
Run
python3 ./etc/update.py path/to/tarball
. -
Update
etc/COMMIT
with the commit number. -
Build and test the bindings as above, then submit a PR!
Dependencies
~4–6MB
~92K SLoC