From c89da11da79737bd065296b07d04cf66011e52fe Mon Sep 17 00:00:00 2001 From: Henri Payno Date: Tue, 23 Jun 2026 15:58:31 +0200 Subject: [PATCH] Doc: add `Example of an installation with conda for test` in contribute --- doc/contribute.rst | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/doc/contribute.rst b/doc/contribute.rst index fbc5ebb0..a8808ce5 100644 --- a/doc/contribute.rst +++ b/doc/contribute.rst @@ -7,6 +7,7 @@ This project follows the standard open-source project github workflow, which is Testing ======= + To run self-contained tests, from Python: .. code-block:: python @@ -24,6 +25,36 @@ To also run tests relying on actual HDF5 files, run from the source directory:: This tests the installed version of `hdf5plugin`. +Example of an installation with conda for test +.............................................. + +1. `Install conda `_ if needed & create conda environment for testing + +.. code-block:: bash + + conda create -n hdf5plugins_env python=3.XX + conda activate hdf5plugins_env + +2. Install requirements + +.. code-block:: bash + + conda install compilers + pip install py-cpuinfo setuptools + +3. Build + +.. code-block:: bash + + python setup.py build + +4. Run the test + +.. code-block:: bash + + PYTHONPATH=build/lib.linux-x86_64-cpython-3{XX}/ python test/test.py -vvv + + Formatting/Linting ==================