The Python scientific stack, compiled to WebAssembly
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
.circleci Merge pull request #223 from rth/pure-python-tests Oct 15, 2018
benchmark Make `make benchmark` work again Oct 8, 2018
bin Use bash instead of dash shell on ubuntu Sep 25, 2018
cpython Set #undef HAVE_UTIMENSAT and HAVE_SIGACTION Sep 27, 2018
docs Add a package-loading version of runPython Oct 9, 2018
emsdk Fix patch Oct 2, 2018
lz4 Use LZ4 filesystem compression, using the canonical C implementation Sep 19, 2018
packages Add another subpackage to matplotlib Oct 10, 2018
pyodide_build Merge pull request #219 from rth/fix-symlink-generation Oct 15, 2018
six Add documentation to new build tools. Jun 22, 2018
src Merge pull request #217 from mdboom/runpython-async Oct 11, 2018
test Check find_imports('import matplotlib.pyplot as plt') Oct 15, 2018
tools Upgrade to emscripten 1.38.12 Oct 1, 2018
.clang-format Add linting Jun 14, 2018
.editorconfig Fix #71: Upgrade to Python 3.7 Sep 6, 2018
.gitignore Converting tools scripts to a python package Sep 20, 2018
CHANGELOG.md Add some community and contributing guidelines Jun 7, 2018
CODE-OF-CONDUCT.md Update link to recurse center code of conduct Jul 18, 2018
CONTRIBUTING.md Add linting Jun 14, 2018
Dockerfile Address review comments and use the new iodide/pyodide-env:0.3.0 image Oct 15, 2018
LICENSE Initial commit Feb 23, 2018
Makefile Simplify make lint Oct 8, 2018
Makefile.envs Update PATH Oct 2, 2018
README.md Provide a Docker image for building Oct 8, 2018
remove_modules.txt Lots of pandas fixes: Apr 24, 2018
run_docker Increment iodide/pyodide-env image to 0.3.0 also in run_docker Oct 16, 2018
setup.cfg Copy test data in a pytest fixture Aug 28, 2018

README.md

Pyodide

Build Status

The Python scientific stack, compiled to WebAssembly.

It provides transparent conversion of objects between Javascript and Python. When inside a browser, this means Python has full access to the Web APIs.

While closely related to the iodide project, Pyodide may be used standalone in any context where you want to run Python inside a web browser.

See the demo

Building

Building is easiest on Linux. For other platforms, we recommend using the Docker image (described below) to build Pyodide.

Make sure the prerequisites for emsdk are installed. Pyodide will build a custom, patched version of emsdk, so there is no need to build it yourself prior.

Additional build prerequisites are:

  • A working native compiler toolchain, enough to build CPython.
  • A native Python 3.7 to run the build scripts.
  • PyYAML
  • lessc to compile less to css.
  • uglifyjs to minify Javascript builds.
  • ccache (optional) recommended for much faster rebuilds.

make

Using Docker

We provide a Debian-based Docker image on Docker Hub with the dependencies already installed to make it easier to build Pyodide.

  1. Install Docker

  2. From a git checkout of Pyodide, run ./run_docker

  3. cd /src

  4. Run make to build.

You can edit the files in your source checkout on your host machine, and then repeatedly run make inside the Docker environment to test your changes.

Testing

Install the following dependencies into the default Python installation:

pip install pytest selenium pytest-instafail

Install geckodriver and chromedriver somewhere on your PATH.

pytest test/

Benchmarking

Install the same dependencies as for testing.

make benchmark

Linting

Python is linted with flake8. C and Javascript are linted with clang-format.

make lint