mirror of
https://github.com/tj/git-extras.git
synced 2026-09-15 09:56:19 -04:00
88 lines
2.1 KiB
Markdown
88 lines
2.1 KiB
Markdown
git-pr(1) -- Checks out a pull request locally
|
|
=================================
|
|
|
|
## SYNOPSIS
|
|
|
|
`git-pr` <number> [<remote>]<br>
|
|
`git-pr` <[remote]:number>...<br>
|
|
`git-pr` <url>...<br>
|
|
`git-pr clean`
|
|
|
|
## DESCRIPTION
|
|
|
|
Creates a local branch based on a GitHub pull request number or URL, and
|
|
switch to that branch afterwards.
|
|
|
|
## OPTIONS
|
|
|
|
<remote>
|
|
|
|
The name of the remote to fetch from. Defaults to `origin`.
|
|
|
|
<url>
|
|
|
|
GitHub pull request URL in the format `https://github.com/tj/git-extras/pull/453`.
|
|
|
|
## EXAMPLES
|
|
|
|
This checks out the pull request `226` from `origin`:
|
|
|
|
$ git pr 226
|
|
|
|
remote: Counting objects: 12, done.
|
|
remote: Compressing objects: 100% (9/9), done.
|
|
remote: Total 12 (delta 3), reused 9 (delta 3)
|
|
Unpacking objects: 100% (12/12), done.
|
|
From https://github.com/tj/git-extras
|
|
* [new ref] refs/pull/226/head -> pr/226
|
|
|
|
Switched to branch 'pr/226'
|
|
|
|
This pulls from a different remote:
|
|
|
|
$ git pr 226 upstream
|
|
|
|
This does the same thing as the command above:
|
|
|
|
$ git pr upstream:226
|
|
|
|
You can also checkout a pull request based on a GitHub URL:
|
|
|
|
$ git pr https://github.com/tj/git-extras/pull/453
|
|
|
|
From https://github.com/tj/git-extras
|
|
* [new ref] refs/pull/453/head -> pr/453
|
|
Switched to branch 'pr/453'
|
|
|
|
You could even pull multiple pull requests via the GitHub URL or the ID **with remote specified**:
|
|
|
|
$ git pr upstream:226 upstream:443
|
|
$ git pr upstream:443 https://github.com/tj/git-extras/pull/453
|
|
|
|
Note that `git pr PR-A PR-B` is equal to:
|
|
|
|
$ git pr PR-A
|
|
$ git pr PR-B
|
|
|
|
Therefore, if one of the pull request is failed to pull, this command will still go ahead and pull
|
|
the others. The final exit code will be decided by the result of the final pulling.
|
|
|
|
To clean up old branches:
|
|
|
|
$ git pr clean
|
|
|
|
Deleted branch pr/226 (was b96a8c2).
|
|
Deleted branch pr/220 (was d34dc0f).
|
|
|
|
## AUTHOR
|
|
|
|
Originally from https://gist.github.com/gnarf/5406589
|
|
|
|
## REPORTING BUGS
|
|
|
|
<<https://github.com/tj/git-extras/issues>>
|
|
|
|
## SEE ALSO
|
|
|
|
<<https://github.com/tj/git-extras>>
|