projg2 / pram

PRam: simple bash tool to merge pull requests

PRam

This is an enhanced rewrite of Patrice Clement's pram utility, in bash ¹. It is a tool to ease merging of pull requests and git format patches to ebuild repositories. It incorporates the requirements of Gentoo policies and reduces the necessity of manually updating commit messages²³.

Merging pull requests

To merge GitHub PR #12345, enter your local gentoo.git checkout and type:

pram 12345

This will fetch it from gentoo/gentoo repository, verify the presence of author's sign-off, append appropriate Closes trailer and merge it via git am.

You can request referencing or closing additional bugs using --bug and --closes options appropriately (they can be specified multiple times). Note that PRam appends the relevant trailers only to the last commit in batch; you may want to move them around via editor.

Merging Bugzilla patches

PRam can also merge patches from Gentoo Bugzilla. To do that, use the full URL to the patch file, e.g.:

pram https://123456.bugs.gentoo.org/attachment.cgi?id=123456

PRam will automatically request closing that bug as well. If this is undesirable, remove the added Closes trailer via editor.

Working with other repositories

You can easily use PRam with other repositories. You can either use the --repository option to override the remote GitHub repository or specify a full PR URL:

pram -r foo/gentoo 123
pram https://github.com/foo/gentoo/pull/123

If your repository does not use DCO/GCO, you can use --no-signoff option to disable requiring sign-off.

References

Copyright

PRam is released under the terms of 2-clause BSD license. Please see the included COPYING file for exact license terms.

---

1. Patrice Clement: Gentoo-App-Pram (https://github.com/monsieurp/Gentoo-App-Pram/)↩

2. GLEP 66: Gentoo Git Workflow (https://www.gentoo.org/glep/glep-0066.html)↩

3. GLEP 76: Copyright Policy (https://www.gentoo.org/glep/glep-0076.html)↩