mirror of https://github.com/python/cpython
56 lines
1.1 KiB
Markdown
56 lines
1.1 KiB
Markdown
|
# Python WebAssembly (WASM) build
|
||
|
|
|
||
|
|
This directory contains configuration and helpers to facilitate cross
|
||
|
|
compilation of CPython to WebAssembly (WASM).
|
||
|
|
|
||
|
|
## wasm32-emscripten build
|
||
|
|
|
||
|
|
Cross compiling to wasm32-emscripten platform needs the [Emscripten](https://emscripten.org/)
|
||
|
|
tool chain and a build Python interpreter.
|
||
|
|
All commands below are relative to a repository checkout.
|
||
|
|
|
||
|
|
### Compile a build Python interpreter
|
||
|
|
|
||
|
|
```shell
|
||
|
|
mkdir -p builddir/build
|
||
|
|
pushd builddir/build
|
||
|
|
../../configure -C
|
||
|
|
make -j$(nproc)
|
||
|
|
popd
|
||
|
|
```
|
||
|
|
|
||
|
|
### Fetch and build additional emscripten ports
|
||
|
|
|
||
|
|
```shell
|
||
|
|
embuilder build zlib
|
||
|
|
```
|
||
|
|
|
||
|
|
### Cross compile to wasm32-emscripten
|
||
|
|
|
||
|
|
```shell
|
||
|
|
mkdir -p builddir/emscripten
|
||
|
|
pushd builddir/emscripten
|
||
|
|
|
||
|
|
CONFIG_SITE=../../Tools/wasm/config.site-wasm32-emscripten \
|
||
|
|
emconfigure ../../configure -C \
|
||
|
|
--host=wasm32-unknown-emscripten \
|
||
|
|
--build=$(../../config.guess) \
|
||
|
|
--with-build-python=$(pwd)/../build/python
|
||
|
|
|
||
|
|
emmake make -j$(nproc) python.html
|
||
|
|
```
|
||
|
|
|
||
|
|
### Test in browser
|
||
|
|
|
||
|
|
Serve `python.html` with a local webserver and open the file in a browser.
|
||
|
|
|
||
|
|
```shell
|
||
|
|
emrun python.html
|
||
|
|
```
|
||
|
|
|
||
|
|
or
|
||
|
|
|
||
|
|
```shell
|
||
|
|
python3 -m http.server
|
||
|
|
```
|