Skip to content

Latest commit

 

History

History
74 lines (51 loc) · 1.25 KB

developers.md

File metadata and controls

74 lines (51 loc) · 1.25 KB

Developer Notes

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

Development Tasks

Common development tasks can be run using taskipy. The full list of available tasks can be seen using.

task --list

Linting

Pre-commit hooks can be installed by running

pre-commit install

Linting checks can then be run using

task lint

Tests

Tests can be run with

task test

Build & Test Documentation

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

Documentation

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.