pyodide/README.md

40 lines
1.1 KiB
Markdown

# 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`