Minimal, modern embedded V8 for Python.
- Free software: ISC license
- Unicode support
- Thread safe
- Re-usable contexts
- Binary object is Python agnostic
MiniRacer can be easily used by Django or Flask projects to minify assets, run babel or compile CoffeeScript.
py_mini_racer is straightforward to use:
>>> from py_mini_racer import py_mini_racer
>>> ctx = py_mini_racer.MiniRacer()
>>> ctx.eval('1+1')
2
>>> ctx.eval("var x = {company: 'Sqreen'}; x.company")
u'Sqreen'
>>> print ctx.eval(u"'\N{HEAVY BLACK HEART}'")
❤
>>> ctx.eval("var fun = () => ({ foo: 1 });")
>>> ctx.call("fun")
{u'foo': 1}Variables are kept inside of a context:
>>> ctx.eval("x.company")
u'Sqreen'[1,2,3].map(n => n + 1);PyMiniRacer is only compatible with Python 2.7 at the moment. Python 3 support is on its way.
The PyMiniRacer binary builds have been tested on x86_64 with:
- OSX 10.11
- Ubuntu >= 14.04
- Debian >= 8
- CentOS >= 7
You need pip >= 8.1 to install the wheels - you can check and upgrade yours in this way:
$ pip --version
$ pip install --upgrade pipIt should work on any Linux with a libc >= 2.17 and a wheel compatible pip (>= 8.1).
We built Python wheels (prebuilt binaries) for OSX 64 bits and Linux 64 bits - most recent distributions. You need pip >= 1.4 and setuptools >= 0.8.
$ pip install py-mini-racerYou can build v8 with the command:
$ python setup.py build_v8You can also build the ctype extension:
$ python setup.py build_extWhich automatically builds v8.
You can generate a wheel with the command:
$ python setup.py bdist_wheelwhich builds v8, the extension, and generates a wheel.
If you want to run the tests, you need to build V8 first, then launch:
$ python setup.py test --addopts testsBuilt with love by Sqreen.
PyMiniRacer launch was described in this blog post.
PyMiniRacer is inspired by mini_racer, built for the Ruby world by Sam Saffron.
Tools used in rendering this package:
Lower libc version needed. Export V8 version. Fix circular structures export.