Testing pySTEPS

The pysteps distribution includes a small test suite for some of the modules. To run the tests the pytest package is needed. To install it, in a terminal run:

pip install pytest

Automatic testing

The simplest way to run the pysteps’ test suite is using tox and the tox-conda plugin (conda needed). To install these packages activate your conda development environment and run:

conda install -c conda-forge tox tox-conda

Then, to run the tests, from the repo’s root run:

tox             # Run pytests
tox -e install  # Test package installation
tox -e black    # Test for black formatting warnings

Manual testing

Example data

The pySTEPS build-in tests require the pySTEPS example data installed. See the installation instructions in the Installing the Example data section.

Test an installed package

After the package is installed, you can launch the test suite from any directory by running:

pytest --pyargs pysteps

Test from sources

Before testing the package directly from the sources, we need to build the extensions in-place. To do that, from the root pysteps folder run:

python setup.py build_ext -i

Now, the package sources can be tested in-place using the pytest command on the root of the pysteps source directory. E.g.:

pytest -v --tb=line