Common Python Tasks

common-python-tasks provides reusable, opinionated Poe the Poet tasks for Python development, packaging, releases, containers, and documentation.

Read the complete documentation for the task reference, configuration options, and deployment guidance.

Quick start

Add the package as a development dependency.

uv add --dev common-python-tasks==0.11.0

Expose the default task set in pyproject.toml.

[tool.poe]
include_script = "common_python_tasks:tasks()"

Run the everyday development tasks.

poe format
poe lint
poe test

Select additional task groups with include_tags.

[tool.poe]
include_script = "common_python_tasks:tasks(include_tags=['common', 'docs', 'containers'])"

Tag	Purpose
`common`	Formatting, linting, testing, packaging, and releases
`docs`	Build and serve Zensical documentation
`containers`	Build, run, inspect, and publish container images
`fastapi`	Run the FastAPI and PostgreSQL development stack

Documentation projects can build locally or start a development server.

poe docs-build
poe docs-serve

The documentation workflow guide covers GitHub Actions artifacts, optional Cloudflare Pages previews, and GitHub Pages deployment.

The project is in alpha, so minor releases may contain breaking changes. It is distributed under the MIT license.