Man page - hub-pr(1)

Packages contains this manual

Manual

hub-pr

NAME
SYNOPSIS
COMMANDS
OPTIONS
SEE ALSO

NAME

hub-pr - Manage GitHub Pull Requests for the current repository.

SYNOPSIS

hub pr list [-s STATE ] [-h HEAD ] [-b BASE ] [-o SORT_KEY [ ]] [-f FORMAT ] [-L LIMIT ]
hub pr
checkout PR-NUMBER [ BRANCH ]
hub pr
show [-uc] [-f FORMAT ] [-h HEAD ]
hub pr
show [-uc] [-f FORMAT ] PR-NUMBER

COMMANDS

list

List pull requests in the current repository.

checkout

Check out the head of a pull request in a new branch.

To update the pull request with new commits, use git push .

show

Open a pull request page in a web browser. When no PR-NUMBER is specified, HEAD is used to look up open pull requests and defaults to the current branch name. With --format , print information about the pull request instead of opening it.

OPTIONS

-s, --state STATE

Filter pull requests by STATE . Supported values are: "open" (default), "closed", "merged", or "all".

-h, --head BRANCH

Show pull requests started from the specified head BRANCH . The "OWNER:BRANCH" format must be used for pull requests from forks.

-b, --base BRANCH

Show pull requests based off the specified BRANCH .

-f, --format FORMAT

Pretty print the list of pull requests using format FORMAT (default: "%pC%>(8)%i%Creset %t% l%n"). See the "PRETTY FORMATS" section of git-log(1) for some additional details on how placeholders are used in format. The available placeholders are:

%I: pull request number

%i: pull request number prefixed with "#"

%U: the URL of this pull request

%S: state ("open" or "closed")

%pS: pull request state ("open", "draft", "merged", or "closed")

%sC: set color to red or green, depending on state

%pC: set color according to pull request state

%t: title

%l: colored labels

%L: raw, comma-separated labels

%b: body

%B: base branch

%sB: base commit SHA

%H: head branch

%sH: head commit SHA

%sm: merge commit SHA

%au: login name of author

%as: comma-separated list of assignees

%rs: comma-separated list of requested reviewers

%Mn: milestone number

%Mt: milestone title

%cD: created date-only (no time of day)

%cr: created date, relative

%ct: created date, UNIX timestamp

%cI: created date, ISO 8601 format

%uD: updated date-only (no time of day)

%ur: updated date, relative

%ut: updated date, UNIX timestamp

%uI: updated date, ISO 8601 format

%mD: merged date-only (no time of day)

%mr: merged date, relative

%mt: merged date, UNIX timestamp

%mI: merged date, ISO 8601 format

%n: newline

%%: a literal %

--color[= WHEN ]

Enable colored output even if stdout is not a terminal. WHEN can be one of "always" (default for --color ), "never", or "auto" (default).

-o, --sort KEY

Sort displayed pull requests by "created" (default), "updated", "popularity", or "long-running".

-ˆ, --sort-ascending

Sort by ascending dates instead of descending.

-L, --limit LIMIT

Display only the first LIMIT pull requests.

-u, --url

Print the pull request URL instead of opening it.

-c, --copy

Put the pull request URL to clipboard instead of opening it.

SEE ALSO

hub-issue(1), hub-pull-request(1), hub(1)