Implement git-pr

Readme.md

@@ -71,6 +71,7 @@ $ brew install git-extras
  - `git lock`
  - `git unlock`
  - `git reset-file`
+ - `git pr`
 
 ## git-extras
 
@@ -668,3 +669,14 @@ or reset one file to certain commit
 ```bash
 $ git reset-file .htaccess dc82b19
 ```
+
+## git-pr [number]
+
+Checks out a pull request from GitHub
+
+```bash
+$ git pr 226
+From https://github.com/visionmedia/git-extras
+ * [new ref]       refs/pulls/226/head -> pr/226
+Switched to branch 'pr/226'
+```

bin/git-pr

@@ -0,0 +1,11 @@
+#!/bin/sh
+# Based on https://gist.github.com/gnarf/5406589
+
+if test "$1" = "clean"; then
+  git for-each-ref refs/heads/pr/* --format='%(refname)' | while read ref; do
+    git branch -D ${ref#refs/heads/}
+  done
+else
+  test -z $1 && echo "pr number required." 1>&2 && exit 1
+  git fetch -fu ${2:-origin} refs/pull/$1/head:pr/$1 && git checkout pr/$1
+fi

man/git-pr.1

@@ -0,0 +1,82 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "GIT\-PR" "1" "October 2014" "" "Git Extras"
+.
+.SH "NAME"
+\fBgit\-pr\fR \- Checks out a pull request locally
+.
+.SH "SYNOPSIS"
+\fBgit\-pr\fR <number> [<remote>]
+.
+.br
+\fBgit\-pr clean\fR
+.
+.SH "DESCRIPTION"
+Creates a local branch based on a GitHub pull request number, and switch to that branch afterwards\.
+.
+.SH "OPTIONS"
+<remote>
+.
+.P
+The name of the remote to fetch from\. Defaults to \fBorigin\fR\.
+.
+.SH "EXAMPLES"
+This checks out the pull request \fB226\fR from \fBorigin\fR:
+.
+.IP "" 4
+.
+.nf
+
+$ 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/visionmedia/git\-extras
+ * [new ref]         refs/pull/226/head \-> pr/226
+
+Switched to branch \'pr/226\'
+.
+.fi
+.
+.IP "" 0
+.
+.P
+This pulls from a different remote:
+.
+.IP "" 4
+.
+.nf
+
+$ git pr 226 upstream
+.
+.fi
+.
+.IP "" 0
+.
+.P
+To clean up old branches:
+.
+.IP "" 4
+.
+.nf
+
+$ git pr clean
+
+Deleted branch pr/226 (was b96a8c2)\.
+Deleted branch pr/220 (was d34dc0f)\.
+.
+.fi
+.
+.IP "" 0
+.
+.SH "AUTHOR"
+Originally from https://gist\.github\.com/gnarf/5406589
+.
+.SH "REPORTING BUGS"
+<\fIhttps://github\.com/visionmedia/git\-extras/issues\fR>
+.
+.SH "SEE ALSO"
+<\fIhttps://github\.com/visionmedia/git\-extras\fR>

man/git-pr.md

@@ -0,0 +1,56 @@
+git-pr(1) -- Checks out a pull request locally
+=================================
+
+## SYNOPSIS
+
+`git-pr` &lt;number&gt; [&lt;remote&gt;]<br>
+`git-pr clean`
+
+## DESCRIPTION
+
+  Creates a local branch based on a GitHub pull request number, and switch to 
+  that branch afterwards.
+
+## OPTIONS
+
+  &lt;remote&gt;
+
+  The name of the remote to fetch from. Defaults to `origin`.
+
+## 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/visionmedia/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
+
+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
+
+&lt;<https://github.com/visionmedia/git-extras/issues>&gt;
+
+## SEE ALSO
+
+&lt;<https://github.com/visionmedia/git-extras>&gt;

man/index.txt

@@ -24,6 +24,7 @@ git-info(1)                   git-info
 git-local-commits(1)          git-local-commits
 git-lock(1)                   git-lock
 git-missing(1)                git-missing
+git-pr(1)                     git-pr
 git-rebase-patch(1)           git-rebase-patch
 git-refactor(1)               git-refactor
 git-release(1)                git-release