NAME

Gentoo::App::Pram - Library to fetch a GitHub Pull Request as an am-like patch.

DESCRIPTION

The purpose of this module is to fetch Pull Requests from GitHub's CDN as am-like patches in order to facilitate the merging and closing of Pull Requests. This module also takes care of adding "Closes:" and "Bug:" headers to patches when necessary. See GLEP 0066.

FUNCTIONS

• fetch_patch($patch_url)

  Fetch patch from $patch_url. Return patch as a string.

• modify_patch($patch)

  Modify the patch headers. This function only modifies the headers of the first commit. Namely:

  * Add a "Closes: https://github.com/XXX" header. Check first if it wasn't added already by the contributor. This header is parsed by the Github bot upon merge. The bot then automatically closes the pull request. See https://help.github.com/articles/closing-issues-using-keywords for more info.

  * Add a "Bug: https://bugs.gentoo.org/XXX" header when the `--bug XXX` option is given. This header is parsed by the Gentoo Bugzilla bot upon merge. The bot then writes a message in the bug report. See GLEP 0066 for more info.

  * Add a "Closes: https://bugs.gentoo.org/XXX" header when the `--closes XXX` option is given. This header is parsed by the Gentoo Bugzilla bot upon merge. The bot then automatically closes the bug report. See GLEP 0066 for more info.

• apply_patch($editor, $git_command, $patch)

  Apply $patch onto HEAD of the current git repository using $git_command. This function also shows $patch in $editor for a final review.

VERSION

version 0.200000

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Patrice Clement.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

AUTHOR

Patrice Clement <monsieurp@gentoo.org>

Kent Fredric <kentnl@gentoo.org>