PRAM(9)

NAME
PRam - Tool to ease merging Pull Requests and git patches

SYNOPSIS
pram [<options>] <pr-number|pr-url|patch-url>

DESCRIPTION
Merge specified GitHub PR into the repository in current directory.

OPTIONS

--am-options OPTIONS
    Pass additional options to git am

-b BUG, --bug BUG, -c BUG, --closes BUG
    Reference or close the specific bug, takes either a bug number or URL, can be specified multiple times.

-e EDITOR, --editor EDITOR
    Override the editor used (default: ${EDITOR})

--no-gitconfig
    Do not query options via git config.

--no-api
    Don't use the Codeberg or GitHub REST API even if a personal access token is present at ~/.codeberg-token or ~/.github-token.

-G, --no-gpgsign
    Do not automatically GPG-sign commits

-I, --non-interactive
    Do not interactively ask to merge, just do it."

-r REPO, --repository REPO
    GitHub repo to use (default: gentoo/gentoo)

-s, --signoff
    Add Signed-off-by to commits (the default)

-S, --no-signoff
    Disable adding Signed-off-by to commits

-p, --part-of
    Add Part-of to commits, linking to the PR (the default)

-P, --no-part-of
    Disable adding Part-of to commits

--link-to PULL_REQUEST
    Override the pull request the merge is linked to. This will override the Part-of trailer, as well as the final Closes trailer.

PARAMETERS

<pr-number>
    GitHub PR number

<pr-url>
    Full URL to the pull request

<patch-url>
    URL to a patch file

GIT CONFIG SUPPORT
PRam queries configuration via git config by default. It makes it possible to specify additional options globally via ~/.gitconfig and per-repo via .git/config. Command-line options override configuration files. The following options are currently supported:

string options:
    pram.editor, pram.repo

boolean options (--type bool):
    pram.gpgsign, pram.interactive, pram.signoff

CODEBERG REST API SUPPORT
PRam will use the Codeberg REST API if a token is present at ~/.codeberg-token. See Codeberg documentation on how to create one (https://docs.codeberg.org/advanced/access-token/).

GITHUB REST API SUPPORT
PRam will use the GitHub REST API if a token is present at ~/.github-token. See GitHub documentation on how to create one (https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).

LICENSE
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

AUTHOR
PRam was written by Michał Górny <mgorny@gentoo.org>