Setup Developer Environment

These instructions will take you through the minimal steps required to get a dev environment setup, so you can run the tests locally.

Clone the repository

First clone the repository locally using Git. There is a link on the GitHub interface to allow you to do this. SSH is recommended if you have setup a key. Enter the directory that it is cloned into to continue.

Install dependencies

You can choose to either develop on the host machine using a venv (which requires python 3.11 or later) or to run in a container under VSCode

Local virtualenv

If on a DLS machine make sure you have python >3.11 running by doing module load python/3.11

module load uv
uv sync --group dev
source .venv/bin/activate

See what was installed

To see a graph of the python package dependency tree type:

$ uv tree

VSCode devcontainer

If you are at DLS, then first setup podman and its fix for devcontainer features

code .
# Click on 'Reopen in Container' when prompted
# Open a new terminal

Build and test

Now you have a development environment you can run the tests in a terminal:

uv run tox -p

This will run in parallel the following checks:

• Build the docs using sphinx

• Running tests

• Run static analysis using pyright or mypy

• Run linting using pre-commit