Techcable’s minimal python cookiecutter

A minimal {cookiecutter-url}[cookiecutter] template for Python projects using {setuptools}[setuptools]. It closely follows the recomendations in the official {python-packaging-guide}[packaging guide] and {python-packaging-tutorial}[tutorial]. See below [tutorial(See below for more details; also the {pypa-packging-tutorial}[official tutorial]

For a more complex (but powerful) alternative, consider [cookiecutter-hypermodern-python, upon which this is loosely based.

Included Features

• Formatting with black & isort ^[1]

• Automatically run with lefthook for git hooks (faster than pre-commit)

• Testing with pytest

• A simple Justfile to run all of the above

TODO (Planned Features)

• ❏ Linting with Ruff?

• Already used for isort

• ❏ Use tox for tests

Related Projects

Here are some related projects & resources.

Official Packaging Guidelines

The Python Packaging Authority (PyPa) is the group that publishes pip, setuptools and manages the [pypi.org] package registry.

They have now pubished an official guide to python packaging: The {packaging-guide-official}[Python Packaging User Guide], which gives best practices.

Key Links

• Project Summaries — Project summaries, offering alternatie tools & build systems.

Obligatory XKCD: Python Environment

---

1. Actually uses Ruff for speed