Skip to main content

Tool for combining GitHub pull requests.

Project description

Tool for combining GitHub pull requests.

License:MPL v2
Documentation:this README


With pipx:

pipx install paul-mclendahand

With pip from PyPI:

pip install paul-mclendahand

With pip from GitHub master branch:

pip install

Quick start

Configure git to fetch pull request references

First, you need to have git configured to fetch pull request references. I have an additional fetch line in my remote for For example, this is what I have for socorro:

[remote "upstream"]
    url =
    fetch = +refs/heads/*:refs/remotes/upstream/*
    fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*

The line you need to add is the last one. Make sure to use the right remote:

fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*
                                       use your remote name here

After adding that, when you do git pull, it’ll pull down all the references for pull requests. They’ll be available as upstream/pr/PRNUM.

Configure pmac

pmac needs to know the GitHub user and GitHub project.

You can do that using environment variables:


or by adding a section to the setup.cfg file:


Using pmac

After you’ve configured git, then you can use pmac like this:

  1. Create a new branch:

    git checkout master
    git checkout -b update-prs
  2. List open PRs:

    pmac listprs
  3. Combine some pull requests into it:

    pmac add 5100 5101 5102

    Use the same pull requests numbers as on GitHub.

    If you hit a cherry-pick conflict, pmac will tell you. You can edit the file in another terminal to manually resolve the conflict. Then do:

    git add FILE
    git commit

    After that, you can continue with pmac.

  4. When you’re done, push the branch to GitHub and create a pull request.

    pmac can help with the PR description:

    pmac prmsg

Why does this project exist?

Two main reasons.

First, GitHub doesn’t support combining pull requests. There is a forum post about it here:

Second, dependabot (also owned by GitHub) doesn’t support grouping dependency updates into a single pull request. If you have 50 dependency updates, it creates 50 pull requests. I have a lot of projects and lack of grouping updates makes monthly maintenance miserable. There’s an issue for this:


1.0.0 (January 14, 2020)

  • Initial writing.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for paul-mclendahand, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size paul_mclendahand-1.0.0-py2.py3-none-any.whl (11.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size paul-mclendahand-1.0.0.tar.gz (10.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page