Repository Template for Python 3.11 Projects

Tools for Project and Package Management

Python projects are managed with PDM (link to GitHub Source), a PEP-compliant project and dependency management tool. The applicable settings are contained within the PyProject-TOML file. In order to use a repo which was created with this template is to tell PDM which Python interpreter to use and then to install the whole project into the created virtual environment. If the interpreter is not available you will need to install it via PDM.

pdm use 3.11.11 # example of a given version
pdm install

This installs all mandatory development dependencies such as:

• Ruff (formatting and linting)
• pytest (unittest framework)
• coverage.py (measuring test coverage)
• pytest-cov (integration of coverage into pytest)
• pytest-xdist (allows to execute the tests on multiple CPU cores)
• bump-my-version (CLI tool to manage version bumping)
• Nox (Python runner, e.g. to run test suite on multiple Python versions)
• pdoc (to auto-generate documentation from docstrings)
• Jupyterlab and widgets (to perform fast prototyping and enable exploratory data analysis)