This is my project structure for new Python projects. It uses the following tools to automate the development process:
poetry
: Reproducible dependency management and packagingtox
: Test and workflow automation against different Python environmentspytest
: Unittestsblack
: Code formattingisort
: Code imports formattingflake8
: Code lintingmypy
: Static type checking
My goal was to provide an easy to start setup with all development good practices implemented.
I intentionally did not provide a setup.py
/ setup.cfg
configuration because this package is managed by Poetry's
build system. This follows PEP 517 where setuptools
is no longer the
default build system for Python. Instead it is possible to configure build systems via pyproject.toml
. Poetry provides
a consistent configuration solely based on the pyproject.toml
file. Read more details
here: https://setuptools.pypa.io/en/latest/build_meta.html.
Install poetry
on your machine if not yet installed. Install the project dependencies
using:
poetry install
You can invoke all workflows using the tox
CLI:
tox -e format # Format code
tox -e lint # Lint code
tox -e format,lint # Format first and then lint
tox -e python3.10 # Run pytest tests for Python 3.10 environment
# Run all workflows in logical order:
# format -> lint -> pytest against all Python environments
tox
It might be useful to find the Python interpreter path for integration with your IDE. Print the path using:
poetry env info --path
For usage from command-line directly run:
poetry run <command> # Will run any command within the Poetry Python virtual environment
poetry shell # Will start a new shell as child process (recommended)
source `poetry env info --path`/bin/activate # Activation in current shell