Dependencies can be installed with poetry by running
poetry install
This will initialise a virtual environment,.venv
in
the project root (this behaviour can be modified in
the poetry.toml
file). This environment
can then be activated with
source .venv/bin/activate
Common development tasks can be run using taskipy. The full list of available tasks can be seen using.
task --list
Pre-commit hooks can be installed by running
pre-commit install
Linting checks can then be run using
task lint
Tests can be run with
task test
Docs can be built using Sphinx by running
task docs
Built docs will be generated in the docs/build
folder.
Likewise, documentation tests can be run with
task doc-tests
Building documentation also automatically builds API documentation from docstrings. Docstrings should be written using the Numpy format. Types should be documented using typehints not in the docstring.