Creates repo.branch function, closes github-tools#36

mattpass · mattpass · commit a5ae9bd5685e · 2013-10-02T08:32:37.000+01:00
Commit with tweaks from @itsjoesullivan, see pull github-tools#37 Combined if statement, got rid of whitespace and made note of default to master in README.md
diff --git a/README.md b/README.md
@@ -61,6 +61,12 @@ Fork repository. This operation runs asynchronously. You may want to poll for `r
 repo.fork(function(err) {});
 ```
 
+Create new branch for repo. You can omit oldBranchName to default to "master".
+
+```js
+repo.branch(oldBranchName, newBranchName, function(err) {}); 
+```
+
 Create Pull Request.
 
 ```js
diff --git a/github.js b/github.js
@@ -354,6 +354,24 @@
         _request("POST", repoPath + "/forks", null, cb);
       };
 
+      // Branch repository  
+      // --------  
+ 
+      this.branch = function(oldBranch,newBranch,cb) {
+        if(arguments.length === 2 && typeof arguments[1] === "function") {
+          cb = newBranch;
+          newBranch = oldBranch;
+          oldBranch = "master";
+        }
+        this.getRef("heads/" + oldBranch, function(err,ref) {
+          if(err && cb) return cb(err);
+          that.createRef({
+            ref: "refs/heads/" + newBranch,
+            sha: ref
+          },cb);
+        });
+      }
+
       // Create pull request
       // --------
 
