Python packages with Poetry

We use Poetry to manage our python packages. You can see the current list of required packages in the pyproject.toml file.

Once in a while we update the required versions with poetry-plugin-up.

If you need to add or update a package, you can do it in your dev branch. Since it will be reflected in the pyproject.toml file, it will be reviewed with the rest of the PR. The updated packages are installed automatically during deployment.

After doing changes to the package list, you may need to do the install the packages both in your docker container: docker compose exec web poetry install and in your local environment: poetry install, depending on how your local setup is.

When you run tests with docker compose run --rm web poetry run pytest, or more generally if you run any command through docker compose run, Docker will use the last build of the Tapir image to run the tests in. That last build may not have your updated package requirement, if it was built before you updated the requirements. You can fix that by running docker compose build.