Minimal, modern embedded V8 for Python

python Mini Racer

Minimal, modern embedded V8 for Python.

Free software: ISC license

Features 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.

Examples

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); Compatibility

PyMiniRacer is only compatible with Python 2.7 at the moment. Python 3 support is on its way.

Binary builds availability

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 pip

It should work on any linux with a libc >= 2.17 and a wheel compatible pip (>= 8.1).

Installation

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-racer Build

You can build v8 with the command:

$ python setup.py build_v8

You can also build the ctype extension:

$ python setup.py build_ext

Which automatically builds v8.

You can generate a wheel with the command:

$ python setup.py bdist_wheel

which builds v8, the extension, and generates a wheel.

Tests

If you want to run the tests, you need to build V8 first, then launch:

$ python setup.py test --addopts tests Credits

Built with love by Sqreen .

PyMiniRacer launch was described in this blog post .

PyMiniRacer is inspired bymini_racer, built for the Ruby world by Sam Saffron.

Tools used in rendering this package:

Cookiecutter cookiecutter-pypackage Todo

Lower libc version needed. Export V8 version. Fix circular structures export.