Added Repository.createTag API

mattyclarkson · John Haley · commit 08698afebb01 · 2015-02-27T14:22:12.000-07:00
This allows a user to easily create an annotated tag in a repository:

```
repository.createTag(oid, '0.0.0', 'version 0.0.0')
  .then(function(tag) {
    // The new tag is returned
  });
```
diff --git a/lib/repository.js b/lib/repository.js
@@ -268,6 +268,30 @@ Repository.prototype.getTree = function(oid, callback) {
   }, callback);
 };
 
+/**
+ * Creates a new annotated tag
+ *
+ * @async
+ * @param {String|Oid} String sha or Oid
+ * @param {String} name the name of the tag
+ * @param {String} message the description that will be attached to the
+ * annotated tag
+ * @return {Tag}
+ */
+Repository.prototype.createTag = function(oid, name, message, callback) {
+  var repository = this;
+  var signature = repository.defaultSignature();
+
+  return Commit.lookup(repository, oid)
+    .then(function(commit) {
+      // Final argument is `force` which overwrites any previous tag
+      return Tag.create(repository, name, commit, signature, message, 0);
+    })
+    .then(function(tagOid) {
+      return repository.getTag(tagOid, callback);
+    });
+};
+
 /**
  * Retrieve the tag represented by the oid.
  *
