2018-02-24 17:52:47 +00:00
|
|
|
# Pyodide
|
|
|
|
|
|
2018-03-30 18:10:03 +00:00
|
|
|
[](https://travis-ci.org/iodide-project/pyodide)
|
|
|
|
|
|
2018-02-24 17:52:47 +00:00
|
|
|
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.
|
2018-02-23 19:34:33 +00:00
|
|
|
|
|
|
|
|
# Building
|
|
|
|
|
|
|
|
|
|
These instructions were tested on Linux. OSX should be substantively the same.
|
|
|
|
|
|
2018-03-30 17:08:06 +00:00
|
|
|
Make sure the prerequisites for emsdk are installed.
|
2018-02-23 19:34:33 +00:00
|
|
|
|
2018-04-26 15:04:28 +00:00
|
|
|
Install [lessc](https://lesscss.org/) to compile less to css.
|
|
|
|
|
|
2018-03-30 17:08:06 +00:00
|
|
|
Type `make`.
|
2018-02-23 19:34:33 +00:00
|
|
|
|
2018-03-30 17:08:06 +00:00
|
|
|
(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.)
|
2018-03-30 14:51:13 +00:00
|
|
|
|
|
|
|
|
# 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`
|
2018-04-11 14:17:02 +00:00
|
|
|
|
|
|
|
|
# Benchmarking
|
|
|
|
|
|
|
|
|
|
1. Install the same dependencies as for testing.
|
|
|
|
|
|
|
|
|
|
2. `make benchmark`
|
