feature(repository): add method to get a single commit

randalpinto · clayreimann · commit aa7ba49d8b84 · 2016-05-23T08:53:47.000-05:00
See: https://developer.github.com/v3/repos/commits/#get-a-single-commit
diff --git a/lib/Repository.js b/lib/Repository.js
@@ -174,6 +174,18 @@ class Repository extends Requestable {
       return this._request('GET', `/repos/${this.__fullname}/commits`, options, cb);
    }
 
+    /**
+     * Gets a single commit information for a repository
+     * @see https://developer.github.com/v3/repos/commits/#get-a-single-commit
+     * @param {string} ref - the reference for the commit-ish
+     * @param {Requestable.callback} cb - will receive the commit information
+     * @return {Promise} - the promise for the http request
+     */
+   getSingleCommit(ref, cb) {
+      ref = ref || '';
+      return this._request('GET', `/repos/${this.__fullname}/commits/${ref}`, null, cb);
+   }
+
    /**
     * Get tha sha for a particular object in the repository. This is a convenience function
     * @see https://developer.github.com/v3/repos/contents/#get-contents
diff --git a/test/repository.spec.js b/test/repository.spec.js
@@ -138,6 +138,23 @@ describe('Repository', function() {
          }));
       });
 
+      it('should get the latest commit from master', function(done) {
+         remoteRepo.getSingleCommit('master', assertSuccessful(done, function(err, commit) {
+            expect(commit).to.have.own('sha');
+            expect(commit).to.have.own('commit');
+            expect(commit).to.have.own('author');
+
+            done();
+         }));
+      });
+
+      it('should fail when null ref is passed', function(done) {
+         remoteRepo.getSingleCommit(null, assertFailure(done, function(err) {
+            expect(err.status).to.be(404);
+            done();
+         }));
+      });
+
       it('should show repo contributors', function(done) {
          remoteRepo.getContributors(assertSuccessful(done, function(err, contributors) {
             if (!(contributors instanceof Array)) {
