Tuturials

For some example applications look into the tutorials provided with the documentation. They are designed to be self-explanatory, and are set up as Jupyter notebooks.

Development

Test suite

Before committing changes or opening a pull request (PR) to the code base, please make sure that all tests pass. The test suite is managed by tox and is configured to use system-wide packages when available. Install the test dependencies as follows:

$> pip install -e .[tests]

The test suite can be run from anywhere in the project tree by issuing:

$> tox

To display the defined test environments and target them individually:

$> tox -l
$> tox -e style,lint,test,docs

To test individual files:

$> flake8 src/pyunicorn/core/network.py     # style check
$> pylint src/pyunicorn/core/network.py     # static code analysis
$> pytest tests/test_core/test_network.py   # unit tests