Added stop build functionality

Author: Johan Hjerling

README.md

@@ -82,6 +82,15 @@ Trigger a build for a job.
 
 * `job_name` _String_
 
+#### `.stopBuild`
+
+Request to stop a build for a job.
+
+##### Parameters
+
+* `job_name` _String_
+* `build_number` _Number_
+
 #### `.queue`
 
 Get current build queue.

lib/client.js

@@ -34,7 +34,6 @@ Jenkins.prototype.lastBuildInfo = function (job, cb) {
       var errorMessages = {
         404: 'Could not find a last build for job: ' + job
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 
@@ -51,7 +50,6 @@ Jenkins.prototype.buildInfo = function (job, buildNumber, cb) {
       var errorMessages = {
         404: 'Could not find build #' + buildNumber + ' for job: ' + job
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
     cb(null, body, res);
@@ -67,7 +65,6 @@ Jenkins.prototype.jobInfo = function (job, cb) {
       var errorMessages = {
         404: 'Could not find job: ' + job
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 
@@ -84,7 +81,6 @@ Jenkins.prototype.buildOutput = function (job, buildNumber, cb) {
       var errorMessages = {
         404: 'Could not find build #' + buildNumber + ' for job: ' + job
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 
@@ -105,14 +101,31 @@ Jenkins.prototype.build = function (job, cb) {
       var errorMessages = {
         404: 'Could not find job: ' + job
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 
     var message = {
       message: 'Build triggered for job: ' + job
     };
+    cb(null, message, res);
+  });
+};
+
+Jenkins.prototype.stopBuild = function (job, buildNumber, cb) {
+  var url = baseUrl + '/job/' + job + '/' + buildNumber + '/stop';
+  request.post(url, function (err, res) {
+    if (err) return cb(err);
 
+    if (res.statusCode !== 200 && res.statusCode !== 302) {
+      var errorMessages = {
+        404: 'Could not find build #' + buildNumber + ' for job: ' + job
+      };
+      return throwErrorBasedOnResponseCode(res, errorMessages, cb);
+    }
+
+    var message = {
+      message: 'Requested to stop build #' + buildNumber + ' for job: ' + job
+    };
     cb(null, message, res);
   });
 };
@@ -126,7 +139,6 @@ Jenkins.prototype.jobList = function (cb) {
       var errorMessages = {
         404: 'Could not find the job list for Jenkins server: ' + baseUrl
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 
@@ -143,7 +155,6 @@ Jenkins.prototype.queue = function (cb) {
       var errorMessages = {
         404: 'Could not find the build queue for Jenkins server: ' + baseUrl
       };
-
       return throwErrorBasedOnResponseCode(res, errorMessages, cb);
     }
 

test/index.js

@@ -154,6 +154,26 @@ describe('Jenkins', function () {
     });
   });
 
+  describe('stopBuild', function () {
+    it('return json object for stopBuild', function (done) {
+      nock('http://jenkins.org').post('/job/job/1/stop').reply(200, '{}');
+      jenkins.stopBuild('job', 1, function (err, stopResponse) {
+        assert.ifError(err);
+        assert.equal(typeof stopResponse, 'object');
+        done();
+      });
+    });
+
+    it('throws an error if jenkins returns a 404', function (done) {
+      nock('http://jenkins.org').post('/job/job/2/stop').reply(404, '{}');
+      jenkins.stopBuild('job', 2, function (err) {
+        assert(err);
+        assert.equal(err.message, 'Could not find build #2 for job: job');
+        done();
+      });
+    });
+  });
+
   describe('queue', function () {
     it('return json object for queue', function (done) {
       nock('http://jenkins.org').get('/queue/api/json').reply(200, '{}');