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 main 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 set configuration in the setup.cfg file:


You can override the setup.cfg variables with environment variables:


You can also pass the git remote on the command line using the --git_remote argument.

If you don’t specify a remote, then pmac will guess it using a highly sophisticated deterministic stochastic rainbow chairs algorithm.

Using pmac

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

  1. Create a new branch:

    git checkout <MAIN-BRANCH>
    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.2.0 (June 24th, 2020)


  • Added a PMAC_MAIN_BRANCH environment variable and main_branch configuration option which specify the name of the main branch. (#12)

1.1.0 (April 7th, 2020)


  • Added a --git_remote argument, PMAC_GIT_REMOTE environment variable, and git_remote configuration option which, when specified, will cause pmac to use that as the remote name and not guess. (#10)


  • Added a Makefile because that’s how I roll.
  • Tweaked pmac --help so it shows the version and release date and link to issue tracker.
  • Cleaned up README.
  • Made a peanut butter pie and ate it.

1.0.0 (January 14, 2020)

  • Initial writing.

Project details

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.2.0
Filename, size File type Python version Upload date Hashes
Filename, size paul_mclendahand-1.2.0-py2.py3-none-any.whl (12.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size paul-mclendahand-1.2.0.tar.gz (11.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page