Skip to content

Commit 470540e

Browse files
Add docs about testing PyArrow pyemscripten wheel
1 parent 5dce9f4 commit 470540e

1 file changed

Lines changed: 17 additions & 0 deletions

File tree

‎docs/source/developers/cpp/emscripten.rst‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,23 @@ go to ``arrow/python`` and run
7575
It should make a wheel targeting the currently enabled version of
7676
Pyodide in the ``dist`` subdirectory.
7777

78+
To test the wheel, you can create a Pyodide virtual environment, which
79+
runs Python in Node.js, and run the PyArrow test suite in it:
80+
81+
.. code:: shell
82+
83+
# create the environment outside of the source tree, so that the
84+
# installed wheel is imported and python/setup.cfg is not used
85+
pyodide venv /tmp/pyarrow-pyodide-venv
86+
source /tmp/pyarrow-pyodide-venv/bin/activate
87+
pip install dist/pyarrow-*.whl hypothesis pandas pytest
88+
cd /tmp/pyarrow-pyodide-venv
89+
python -m pytest --pyargs pyarrow
90+
91+
The tests can also be run in a browser with
92+
``python/scripts/run_emscripten_tests.py``, which needs Selenium and a
93+
`Pyodide distribution <https://github.com/pyodide/pyodide/releases>`_.
94+
7895

7996
Manual Build
8097
------------

0 commit comments

Comments
 (0)