Skip to main content
Patman

Patman patch manager

Test status PyPI version Documentation status Supported Python versions

Patman is a command-line tool that automates the boring parts of preparing and sending patches by email, in the style used by the U-Boot and Linux kernel projects. It:

  • creates patches directly from a git branch;

  • cleans them up by removing unwanted tags and inserting a cover letter;

  • runs checkpatch.pl and the project’s checks before anything is sent;

  • looks up the maintainers to Cc, and emails the series out;

  • tracks series in a local database and integrates with Patchwork to gather review tags and follow up on comments.

Installation

Install the latest release from PyPI:

pip install patch-manager

Optional features are available as extras:

pip install patch-manager[review]   # patch review using a Claude agent
pip install patch-manager[gmail]    # Gmail drafts of reviews and replies
pip install patch-manager[all]      # everything

To try changes before they are released, install the latest code from GitHub instead, with any extras inside the brackets:

pip install "patch-manager[all] @ git+https://github.com/deinde-dev/patman.git"

The version stays the same between releases, so to pick up newer changes later, add --force-reinstall --no-deps, which reinstalls patman without reinstalling the packages it uses:

pip install --force-reinstall --no-deps \
    "patch-manager @ git+https://github.com/deinde-dev/patman.git"

Some distributions, such as recent Debian and Ubuntu, do not let pip install into the system’s Python, failing with ‘externally-managed-environment’. There, install patman with pipx, which gives it its own environment:

pipx install "patch-manager[all]"         # the latest release
pipx install "patch-manager[all] @ git+https://github.com/deinde-dev/patman.git"

To update it, use pipx upgrade patch-manager for a release, or pipx reinstall patch-manager for the latest code from GitHub.

The patman command is then on your path. It is also installed as patch-manager, which is the only name the Debian package provides, since Debian already has an unrelated patman command.

Quick start

From a git branch containing the commits you want to send:

patman              # create, check and email the series
patman -n           # dry run: create and check, but do not send

See patman --full-help for the complete manual, or the documentation linked below.

Documentation

The documentation is on Read the Docs, at https://patman.readthedocs.io/ Start with the guide, which goes through using patman step by step with a real U-Boot series:

https://patman.readthedocs.io/en/latest/guide/index.html

There is a short introduction, with a demo, at https://deinde.dev/patman/

Development

Run the test suite from a checkout:

pip install -r requirements.txt
pip install -e .
patman test

The suite is self-contained: a pinned checkpatch.pl and its helper files live in scripts/, and u_boot_pylib is installed from PyPI as u-boot-pylib, so no surrounding U-Boot source is required.

Build the documentation locally with:

pip install -r doc/requirements.txt
make -C doc html

The rendered HTML is written to doc/_build/html.

License

GPL-2.0-or-later. See the LICENSE file for the full text.

Metadata

Release files for patch-manager 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for patch-manager 0.7.0
File Size Uploaded Provenance Actions
patch_manager-0.7.0.tar.gz 652.4 kB With provenance Details for patch_manager-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for patch-manager 0.7.0
File Interpreter ABI Platform Actions
patch_manager-0.7.0-py3-none-any.whl Python 3 none any Details for patch_manager-0.7.0-py3-none-any.whl

Total release size: 1.4 MB

Release files / patch_manager-0.7.0.tar.gz

Download URL patch_manager-0.7.0.tar.gz
Size 652.4 kB
Tags Source
SHA-256 checksum
How to use checksums
2af55d0b915a270c9bd06f2907495298a1b315db0f47bb86334afcde006a716f
BLAKE2b-256 checksum
How to use checksums
090a0434e6efa05807f9cb42a37e02b846b5440cec1f6e46c4a57b834a6cb6d5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / patch_manager-0.7.0-py3-none-any.whl

Download URL patch_manager-0.7.0-py3-none-any.whl
Size 714.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
75857cc93246da741a667969949f09f4ada9e056a0957df011d4a2716d8ac858
BLAKE2b-256 checksum
How to use checksums
b012c7c1f3db523ad10696e7093052cd30bd7605438c6332d21672c63bd6aa7f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for patch-manager 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for patch_manager-0.7.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page