# Pyodide

[![Build Status](https://travis-ci.org/iodide-project/pyodide.svg?branch=master)](https://travis-ci.org/iodide-project/pyodide)

This provides an integration layer when running an empscripten-compiled CPython
inside a web browser. It provides transparent conversion of objects between
Javascript and Python and a sharing of global namespaces. When inside a browser,
this means Python has full access to the Web APIs.

# Building

These instructions were tested on Linux. OSX should be substantively the same.

Make sure the prerequisites for emsdk are installed.

Install [lessc](https://lesscss.org/) to compile less to css.

Type `make`.

(The build downloads and builds a local, patched version of emsdk, then
downloads and builds Python and Numpy, and finally builds the pyodide-specific
code.)

# Testing

1. Install the following dependencies into the default Python installation:

   `pip install pytest selenium`

2. Install [geckodriver](https://github.com/mozilla/geckodriver/releases) somewhere
   on your `PATH`.

3. `make test`

# Benchmarking

1. Install the same dependencies as for testing.

2. `make benchmark`