Contribution

To contribute, please open a pull request to the dev-branch on GitHub.

The following is an example of how to set up VS Code for development, adapt to your IDE of choice.

TL;DR:

pip install -e .

Requirements

  • VS Code with the Python extension

  • Python 3.10 or above

Setup

  1. Clone the repo recursively and open the repo in VS Code. If not cloned recursively, initialize the submodules with git submodule update --init

  2. Press f1, and run Python: Create Environment. Select .venv

  3. Open a new terminal, which should automatically use the virtual environment. If not, run .venv\Scripts\activate on Windows, or source .venv/bin/activate on Unix

  4. In the same terminal, run pip install -e .[test] to install the current directory in an editable state, and the testing utility Pytest

  5. To run tests, press f1 and run Python: Configure Tests. Choose pytest. Run tests in the testing menu