Skip to content

Testing

Testing commands are consolidated using the nox-poetry package.

Nox manages virtual environments for different versions of python and consolidates development activities (e.g., testing, static type-checking) into a cli interface, while nox-poetry ensures that nox sessions have access to the same dependencies as the project's poetry.lock file.

Using nox in CLI

Nox CLI commands can be viewed by running the following command from the project root:

poetry run nox

Updating nox

Nox commands can be updated in the noxfile.py file located in the project root.

Key nox-poetry session methods

Make all poetry.lock dependencies (including dev) available to nox sessions:

1
session.run_always("poetry", "install", external=True)

Build package wheel and install within nox session using pip (e.g., for testing):

1
session.install(".")

1
session.installroot()

Install third-party packages, defaulting to the version specified in poetry.lock:

1
session.install("pytest")