epuber-stylus-source 0.54.8 → 0.56.0

data/vendor/node_modules/mocha/lib/runner.js

@@ -4,7 +4,6 @@
  * Module dependencies.
  * @private
  */
-var util = require('util');
 var EventEmitter = require('events').EventEmitter;
 var Pending = require('./pending');
 var utils = require('./utils');
@@ -19,8 +18,6 @@ var EVENT_ROOT_SUITE_RUN = Suite.constants.EVENT_ROOT_SUITE_RUN;
 var STATE_FAILED = Runnable.constants.STATE_FAILED;
 var STATE_PASSED = Runnable.constants.STATE_PASSED;
 var STATE_PENDING = Runnable.constants.STATE_PENDING;
-var dQuote = utils.dQuote;
-var sQuote = utils.sQuote;
 var stackFilter = utils.stackTraceFilter();
 var stringify = utils.stringify;
 
@@ -138,9 +135,11 @@ class Runner extends EventEmitter {
    * @public
    * @class
    * @param {Suite} suite - Root suite
-   * @param {Object|boolean} [opts] - Options. If `boolean`, whether or not to delay execution of root suite until ready (for backwards compatibility).
-   * @param {boolean} [opts.delay] - Whether to delay execution of root suite until ready.
+   * @param {Object|boolean} [opts] - Options. If `boolean` (deprecated), whether to delay execution of root suite until ready.
    * @param {boolean} [opts.cleanReferencesAfterRun] - Whether to clean references to test fns and hooks when a suite is done.
+   * @param {boolean} [opts.delay] - Whether to delay execution of root suite until ready.
+   * @param {boolean} [opts.dryRun] - Whether to report tests without running them.
+   * @param {boolean} [opts.failZero] - Whether to fail test run if zero tests encountered.
    */
   constructor(suite, opts) {
     super();
@@ -148,7 +147,10 @@ class Runner extends EventEmitter {
       opts = {};
     }
     if (typeof opts === 'boolean') {
-      // TODO: deprecate this
+      // TODO: remove this
+      require('./errors').deprecate(
+        '"Runner(suite: Suite, delay: boolean)" is deprecated. Use "Runner(suite: Suite, {delay: boolean})" instead.'
+      );
       this._delay = opts;
       opts = {};
     } else {
@@ -166,7 +168,7 @@ class Runner extends EventEmitter {
      * @type {Map<EventEmitter,Map<string,Set<EventListener>>>}
      */
     this._eventListeners = new Map();
-    this.on(constants.EVENT_TEST_END, function(test) {
+    this.on(constants.EVENT_TEST_END, function (test) {
       if (test.type === 'test' && test.retriedTest() && test.parent) {
         var idx =
           test.parent.tests && test.parent.tests.indexOf(test.retriedTest());
@@ -174,7 +176,7 @@ class Runner extends EventEmitter {
       }
       self.checkGlobals(test);
     });
-    this.on(constants.EVENT_HOOK_END, function(hook) {
+    this.on(constants.EVENT_HOOK_END, function (hook) {
       self.checkGlobals(hook);
     });
     this._defaultGrep = /.*/;
@@ -223,7 +225,7 @@ Runner.immediately = global.setImmediate || process.nextTick;
  * @param {string} fn - Listener function
  * @private
  */
-Runner.prototype._addEventListener = function(target, eventName, listener) {
+Runner.prototype._addEventListener = function (target, eventName, listener) {
   debug(
     '_addEventListener(): adding for event %s; %d current listeners',
     eventName,
@@ -233,10 +235,7 @@ Runner.prototype._addEventListener = function(target, eventName, listener) {
   if (
     this._eventListeners.has(target) &&
     this._eventListeners.get(target).has(eventName) &&
-    this._eventListeners
-      .get(target)
-      .get(eventName)
-      .has(listener)
+    this._eventListeners.get(target).get(eventName).has(listener)
   ) {
     debug(
       'warning: tried to attach duplicate event listener for %s',
@@ -263,7 +262,7 @@ Runner.prototype._addEventListener = function(target, eventName, listener) {
  * @param {function} listener - Listener function
  * @private
  */
-Runner.prototype._removeEventListener = function(target, eventName, listener) {
+Runner.prototype._removeEventListener = function (target, eventName, listener) {
   target.removeListener(eventName, listener);
 
   if (this._eventListeners.has(target)) {
@@ -287,7 +286,7 @@ Runner.prototype._removeEventListener = function(target, eventName, listener) {
  * Removes all event handlers set during a run on this instance.
  * Remark: this does _not_ clean/dispose the tests or suites themselves.
  */
-Runner.prototype.dispose = function() {
+Runner.prototype.dispose = function () {
   this.removeAllListeners();
   this._eventListeners.forEach((targetListeners, target) => {
     targetListeners.forEach((targetEventListeners, eventName) => {
@@ -309,7 +308,7 @@ Runner.prototype.dispose = function() {
  * @param {boolean} invert
  * @return {Runner} Runner instance.
  */
-Runner.prototype.grep = function(re, invert) {
+Runner.prototype.grep = function (re, invert) {
   debug('grep(): setting to %s', re);
   this._grep = re;
   this._invert = invert;
@@ -326,11 +325,11 @@ Runner.prototype.grep = function(re, invert) {
  * @param {Suite} suite
  * @return {number}
  */
-Runner.prototype.grepTotal = function(suite) {
+Runner.prototype.grepTotal = function (suite) {
   var self = this;
   var total = 0;
 
-  suite.eachTest(function(test) {
+  suite.eachTest(function (test) {
     var match = self._grep.test(test.fullTitle());
     if (self._invert) {
       match = !match;
@@ -349,7 +348,7 @@ Runner.prototype.grepTotal = function(suite) {
  * @return {Array}
  * @private
  */
-Runner.prototype.globalProps = function() {
+Runner.prototype.globalProps = function () {
   var props = Object.keys(global);
 
   // non-enumerables
@@ -371,7 +370,7 @@ Runner.prototype.globalProps = function() {
  * @param {Array} arr
  * @return {Runner} Runner instance.
  */
-Runner.prototype.globals = function(arr) {
+Runner.prototype.globals = function (arr) {
   if (!arguments.length) {
     return this._globals;
   }
@@ -385,7 +384,7 @@ Runner.prototype.globals = function(arr) {
  *
  * @private
  */
-Runner.prototype.checkGlobals = function(test) {
+Runner.prototype.checkGlobals = function (test) {
   if (!this.checkLeaks) {
     return;
   }
@@ -407,9 +406,8 @@ Runner.prototype.checkGlobals = function(test) {
   this._globals = this._globals.concat(leaks);
 
   if (leaks.length) {
-    var msg = 'global leak(s) detected: %s';
-    var error = new Error(util.format(msg, leaks.map(sQuote).join(', ')));
-    this.fail(test, error);
+    var msg = `global leak(s) detected: ${leaks.map(e => `'${e}'`).join(', ')}`;
+    this.fail(test, new Error(msg));
   }
 };
 
@@ -434,7 +432,7 @@ Runner.prototype.checkGlobals = function(test) {
  * @param {Error} err
  * @param {boolean} [force=false] - Whether to fail a pending test.
  */
-Runner.prototype.fail = function(test, err, force) {
+Runner.prototype.fail = function (test, err, force) {
   force = force === true;
   if (test.isPending() && !force) {
     return;
@@ -475,7 +473,9 @@ Runner.prototype.fail = function(test, err, force) {
  * @param {Function} fn
  */
 
-Runner.prototype.hook = function(name, fn) {
+Runner.prototype.hook = function (name, fn) {
+  if (this._opts.dryRun) return fn();
+
   var suite = this.suite;
   var hooks = suite.getHooks(name);
   var self = this;
@@ -502,7 +502,7 @@ Runner.prototype.hook = function(name, fn) {
     self.emit(constants.EVENT_HOOK_BEGIN, hook);
 
     if (!hook.listeners('error').length) {
-      self._addEventListener(hook, 'error', function(err) {
+      self._addEventListener(hook, 'error', function (err) {
         self.fail(hook, err);
       });
     }
@@ -527,10 +527,10 @@ Runner.prototype.hook = function(name, fn) {
           hook.pending = false; // activates hook for next test
           return fn(new Error('abort hookDown'));
         } else if (name === HOOK_TYPE_BEFORE_ALL) {
-          suite.tests.forEach(function(test) {
+          suite.tests.forEach(function (test) {
             test.pending = true;
           });
-          suite.suites.forEach(function(suite) {
+          suite.suites.forEach(function (suite) {
             suite.pending = true;
           });
           hooks = [];
@@ -554,8 +554,7 @@ Runner.prototype.hook = function(name, fn) {
     function setHookTitle(hook) {
       hook.originalTitle = hook.originalTitle || hook.title;
       if (hook.ctx && hook.ctx.currentTest) {
-        hook.title =
-          hook.originalTitle + ' for ' + dQuote(hook.ctx.currentTest.title);
+        hook.title = `${hook.originalTitle} for "${hook.ctx.currentTest.title}"`;
       } else {
         var parentTitle;
         if (hook.parent.title) {
@@ -563,12 +562,12 @@ Runner.prototype.hook = function(name, fn) {
         } else {
           parentTitle = hook.parent.root ? '{root}' : '';
         }
-        hook.title = hook.originalTitle + ' in ' + dQuote(parentTitle);
+        hook.title = `${hook.originalTitle} in "${parentTitle}"`;
       }
     }
   }
 
-  Runner.immediately(function() {
+  Runner.immediately(function () {
     next(0);
   });
 };
@@ -582,7 +581,7 @@ Runner.prototype.hook = function(name, fn) {
  * @param {Array} suites
  * @param {Function} fn
  */
-Runner.prototype.hooks = function(name, suites, fn) {
+Runner.prototype.hooks = function (name, suites, fn) {
   var self = this;
   var orig = this.suite;
 
@@ -594,7 +593,7 @@ Runner.prototype.hooks = function(name, suites, fn) {
       return fn();
     }
 
-    self.hook(name, function(err) {
+    self.hook(name, function (err) {
       if (err) {
         var errSuite = self.suite;
         self.suite = orig;
@@ -609,25 +608,25 @@ Runner.prototype.hooks = function(name, suites, fn) {
 };
 
 /**
- * Run hooks from the top level down.
+ * Run 'afterEach' hooks from bottom up.
  *
  * @param {String} name
  * @param {Function} fn
  * @private
  */
-Runner.prototype.hookUp = function(name, fn) {
+Runner.prototype.hookUp = function (name, fn) {
   var suites = [this.suite].concat(this.parents()).reverse();
   this.hooks(name, suites, fn);
 };
 
 /**
- * Run hooks from the bottom up.
+ * Run 'beforeEach' hooks from top level down.
  *
  * @param {String} name
  * @param {Function} fn
  * @private
  */
-Runner.prototype.hookDown = function(name, fn) {
+Runner.prototype.hookDown = function (name, fn) {
   var suites = [this.suite].concat(this.parents());
   this.hooks(name, suites, fn);
 };
@@ -639,7 +638,7 @@ Runner.prototype.hookDown = function(name, fn) {
  * @return {Array}
  * @private
  */
-Runner.prototype.parents = function() {
+Runner.prototype.parents = function () {
   var suite = this.suite;
   var suites = [];
   while (suite.parent) {
@@ -655,7 +654,9 @@ Runner.prototype.parents = function() {
  * @param {Function} fn
  * @private
  */
-Runner.prototype.runTest = function(fn) {
+Runner.prototype.runTest = function (fn) {
+  if (this._opts.dryRun) return Runner.immediately(fn);
+
   var self = this;
   var test = this.test;
 
@@ -666,7 +667,7 @@ Runner.prototype.runTest = function(fn) {
   if (this.asyncOnly) {
     test.asyncOnly = true;
   }
-  this._addEventListener(test, 'error', function(err) {
+  this._addEventListener(test, 'error', function (err) {
     self.fail(test, err);
   });
   if (this.allowUncaught) {
@@ -687,7 +688,7 @@ Runner.prototype.runTest = function(fn) {
  * @param {Suite} suite
  * @param {Function} fn
  */
-Runner.prototype.runTests = function(suite, fn) {
+Runner.prototype.runTests = function (suite, fn) {
   var self = this;
   var tests = suite.tests.slice();
   var test;
@@ -701,8 +702,7 @@ Runner.prototype.runTests = function(suite, fn) {
     self.suite = after ? errSuite.parent : errSuite;
 
     if (self.suite) {
-      // call hookUp afterEach
-      self.hookUp(HOOK_TYPE_AFTER_EACH, function(err2, errSuite2) {
+      self.hookUp(HOOK_TYPE_AFTER_EACH, function (err2, errSuite2) {
         self.suite = orig;
         // some hooks may fail even now
         if (err2) {
@@ -776,7 +776,7 @@ Runner.prototype.runTests = function(suite, fn) {
 
     // execute test and hook(s)
     self.emit(constants.EVENT_TEST_BEGIN, (self.test = test));
-    self.hookDown(HOOK_TYPE_BEFORE_EACH, function(err, errSuite) {
+    self.hookDown(HOOK_TYPE_BEFORE_EACH, function (err, errSuite) {
       // conditional skip within beforeEach
       if (test.isPending()) {
         if (self.forbidPending) {
@@ -789,7 +789,7 @@ Runner.prototype.runTests = function(suite, fn) {
         // skip inner afterEach hooks below errSuite level
         var origSuite = self.suite;
         self.suite = errSuite || self.suite;
-        return self.hookUp(HOOK_TYPE_AFTER_EACH, function(e, eSuite) {
+        return self.hookUp(HOOK_TYPE_AFTER_EACH, function (e, eSuite) {
           self.suite = origSuite;
           next(e, eSuite);
         });
@@ -798,7 +798,7 @@ Runner.prototype.runTests = function(suite, fn) {
         return hookErr(err, errSuite, false);
       }
       self.currentRunnable = self.test;
-      self.runTest(function(err) {
+      self.runTest(function (err) {
         test = self.test;
         // conditional skip within it
         if (test.pending) {
@@ -849,7 +849,7 @@ Runner.prototype.runTests = function(suite, fn) {
  * @param {Suite} suite
  * @param {Function} fn
  */
-Runner.prototype.runSuite = function(suite, fn) {
+Runner.prototype.runSuite = function (suite, fn) {
   var i = 0;
   var self = this;
   var total = this.grepTotal(suite);
@@ -889,7 +889,7 @@ Runner.prototype.runSuite = function(suite, fn) {
     // huge recursive loop and thus a maximum call stack error.
     // See comment in `this.runTests()` for more information.
     if (self._grep !== self._defaultGrep) {
-      Runner.immediately(function() {
+      Runner.immediately(function () {
         self.runSuite(curr, next);
       });
     } else {
@@ -904,7 +904,7 @@ Runner.prototype.runSuite = function(suite, fn) {
     // remove reference to test
     delete self.test;
 
-    self.hook(HOOK_TYPE_AFTER_ALL, function() {
+    self.hook(HOOK_TYPE_AFTER_ALL, function () {
       self.emit(constants.EVENT_SUITE_END, suite);
       fn(errSuite);
     });
@@ -912,7 +912,7 @@ Runner.prototype.runSuite = function(suite, fn) {
 
   this.nextSuite = next;
 
-  this.hook(HOOK_TYPE_BEFORE_ALL, function(err) {
+  this.hook(HOOK_TYPE_BEFORE_ALL, function (err) {
     if (err) {
       return done();
     }
@@ -936,7 +936,7 @@ Runner.prototype.runSuite = function(suite, fn) {
  * @param {Error} err - Some uncaught error
  * @private
  */
-Runner.prototype._uncaught = function(err) {
+Runner.prototype._uncaught = function (err) {
   // this is defensive to prevent future developers from mis-calling this function.
   // it's more likely that it'd be called with the incorrect context--say, the global
   // `process` object--than it would to be called with a context that is not a "subclass"
@@ -1034,14 +1034,16 @@ Runner.prototype._uncaught = function(err) {
  * @param {{files: string[], options: Options}} [opts] - For subclasses
  * @returns {Runner} Runner instance.
  */
-Runner.prototype.run = function(fn, opts = {}) {
+Runner.prototype.run = function (fn, opts = {}) {
   var rootSuite = this.suite;
   var options = opts.options || {};
 
   debug('run(): got options: %O', options);
-  fn = fn || function() {};
+  fn = fn || function () {};
 
   const end = () => {
+    if (!this.total && this._opts.failZero) this.failures = 1;
+
     debug('run(): root suite completed; emitting %s', constants.EVENT_RUN_END);
     this.emit(constants.EVENT_RUN_END);
   };
@@ -1078,7 +1080,7 @@ Runner.prototype.run = function(fn, opts = {}) {
   }
 
   // callback
-  this.on(constants.EVENT_RUN_END, function() {
+  this.on(constants.EVENT_RUN_END, function () {
     this.state = constants.STATE_STOPPED;
     debug('run(): emitted %s', constants.EVENT_RUN_END);
     fn(this.failures);
@@ -1125,7 +1127,7 @@ Runner.prototype.run = function(fn, opts = {}) {
  *   }
  * }
  */
-Runner.prototype.linkPartialObjects = function(value) {
+Runner.prototype.linkPartialObjects = function (value) {
   return this;
 };
 
@@ -1150,7 +1152,7 @@ Runner.prototype.runAsync = async function runAsync(opts = {}) {
  * @public
  * @return {Runner} Runner instance.
  */
-Runner.prototype.abort = function() {
+Runner.prototype.abort = function () {
   debug('abort(): aborting');
   this._abort = true;
 
@@ -1178,7 +1180,7 @@ Runner.prototype.isParallelMode = function isParallelMode() {
  * @chainable
  * @abstract
  */
-Runner.prototype.workerReporter = function() {
+Runner.prototype.workerReporter = function () {
   throw createUnsupportedError('workerReporter() not supported in serial mode');
 };
 
@@ -1191,7 +1193,7 @@ Runner.prototype.workerReporter = function() {
  * @return {Array}
  */
 function filterLeaks(ok, globals) {
-  return globals.filter(function(key) {
+  return globals.filter(function (key) {
     // Firefox and Chrome exposes iframes as index inside the window object
     if (/^\d+/.test(key)) {
       return false;
@@ -1215,7 +1217,7 @@ function filterLeaks(ok, globals) {
       return false;
     }
 
-    var matched = ok.filter(function(ok) {
+    var matched = ok.filter(function (ok) {
       if (~ok.indexOf('*')) {
         return key.indexOf(ok.split('*')[0]) === 0;
       }

data/vendor/node_modules/mocha/lib/stats-collector.js

@@ -56,25 +56,25 @@ function createStatsCollector(runner) {
 
   runner.stats = stats;
 
-  runner.once(EVENT_RUN_BEGIN, function() {
+  runner.once(EVENT_RUN_BEGIN, function () {
     stats.start = new Date();
   });
-  runner.on(EVENT_SUITE_BEGIN, function(suite) {
+  runner.on(EVENT_SUITE_BEGIN, function (suite) {
     suite.root || stats.suites++;
   });
-  runner.on(EVENT_TEST_PASS, function() {
+  runner.on(EVENT_TEST_PASS, function () {
     stats.passes++;
   });
-  runner.on(EVENT_TEST_FAIL, function() {
+  runner.on(EVENT_TEST_FAIL, function () {
     stats.failures++;
   });
-  runner.on(EVENT_TEST_PENDING, function() {
+  runner.on(EVENT_TEST_PENDING, function () {
     stats.pending++;
   });
-  runner.on(EVENT_TEST_END, function() {
+  runner.on(EVENT_TEST_END, function () {
     stats.tests++;
   });
-  runner.once(EVENT_RUN_END, function() {
+  runner.once(EVENT_RUN_END, function () {
     stats.end = new Date();
     stats.duration = stats.end - stats.start;
   });