The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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:" which are Gentoo-specific. 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. 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 functions also shows $patch in $editor for a final review.

VERSION

version 0.100

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 <kentln@gentoo.org>