feat(runner): add a callback for when the tests are done

Add an onCleanUp callback to be able to hook into when all the tests
have been run.

Conflicts:
	referenceConf.js

Author: eddiemonge

lib/runner.js

@@ -84,22 +84,28 @@ var addConfig = function(additionalConfig) {
 var cleanUp = function(runner) {
   var passed = runner.results().failedCount == 0;
   var exitCode = passed ? 0 : 1;
+  var exit = function(exitCode) {
+    if (typeof config.onCleanUp === 'function') {
+      config.onCleanUp(exitCode);
+    }
+    process.exit(exitCode);
+  };
   if (sauceAccount) {
     sauceAccount.updateJob(sessionId, {'passed': passed}, function(err) {
       if (err) {
         throw new Error(
           "Error updating Sauce pass/fail status: " + util.inspect(err)
         );
       }
-      process.exit(exitCode);
+      exit(exitCode);
     });
   } else if (server) {
     util.puts('Shutting down selenium standalone server.');
     server.stop().then(function() {
-      process.exit(exitCode);
+      exit(exitCode);
     });
   } else {
-    process.exit(exitCode);
+    exit(exitCode);
   }
 };
 

referenceConf.js

@@ -120,13 +120,20 @@ exports.config = {
     includeStackTrace: true,
     // Default time to wait in ms before a test fails.
     defaultTimeoutInterval: 30000
-  }
+  },
 
   // ----- Options to be passed to mocha -----
   //
   // See the full list at http://visionmedia.github.io/mocha/
   mochaOpts: {
     ui: 'bdd',
     reporter: 'list'
-  }
+  },
+
+  // ----- The cleanup step -----
+  //
+  // A callback function called once the tests have finished running and
+  // the webdriver instance has been shut down. It is passed the exit code
+  // (0 if the tests passed or 1 if not).
+  onCleanUp: function() {}
 };