mocha 6.1.0 → 6.1.4

package/lib/growl.js

@@ -1,136 +1,136 @@
-'use strict';
-
-/**
- * Desktop Notifications module.
- * @module Growl
- */
-
-const os = require('os');
-const path = require('path');
-const {sync: which} = require('which');
-const {EVENT_RUN_END} = require('./runner').constants;
-
-/**
- * @summary
- * Checks if Growl notification support seems likely.
- *
- * @description
- * Glosses over the distinction between an unsupported platform
- * and one that lacks prerequisite software installations.
- *
- * @public
- * @see {@link https://github.com/tj/node-growl/blob/master/README.md|Prerequisite Installs}
- * @see {@link Mocha#growl}
- * @see {@link Mocha#isGrowlCapable}
- * @return {boolean} whether Growl notification support can be expected
- */
-exports.isCapable = () => {
-  if (!process.browser) {
-    return getSupportBinaries().reduce(
-      (acc, binary) => acc || Boolean(which(binary, {nothrow: true})),
-      false
-    );
-  }
-  return false;
-};
-
-/**
- * Implements desktop notifications as a pseudo-reporter.
- *
- * @public
- * @see {@link Mocha#_growl}
- * @param {Runner} runner - Runner instance.
- */
-exports.notify = runner => {
-  runner.once(EVENT_RUN_END, () => {
-    display(runner);
-  });
-};
-
-/**
- * Displays the notification.
- *
- * @private
- * @param {Runner} runner - Runner instance.
- */
-const display = runner => {
-  const growl = require('growl');
-  const stats = runner.stats;
-  const symbol = {
-    cross: '\u274C',
-    tick: '\u2705'
-  };
-  let _message;
-  let message;
-  let title;
-
-  if (stats.failures) {
-    _message = `${stats.failures} of ${stats.tests} tests failed`;
-    message = `${symbol.cross} ${_message}`;
-    title = 'Failed';
-  } else {
-    _message = `${stats.passes} tests passed in ${stats.duration}ms`;
-    message = `${symbol.tick} ${_message}`;
-    title = 'Passed';
-  }
-
-  // Send notification
-  const options = {
-    image: logo(),
-    name: 'mocha',
-    title
-  };
-  growl(message, options, onCompletion);
-};
-
-/**
- * @summary
- * Callback for result of attempted Growl notification.
- *
- * @description
- * Despite its appearance, this is <strong>not</strong> an Error-first
- * callback -- all parameters are populated regardless of success.
- *
- * @private
- * @callback Growl~growlCB
- * @param {*} err - Error object, or <code>null</code> if successful.
- */
-function onCompletion(err) {
-  if (err) {
-    // As notifications are tangential to our purpose, just log the error.
-    const message =
-      err.code === 'ENOENT' ? 'prerequisite software not found' : err.message;
-    console.error('notification error:', message);
-  }
-}
-
-/**
- * Returns Mocha logo image path.
- *
- * @private
- * @return {string} Pathname of Mocha logo
- */
-const logo = () => {
-  return path.join(__dirname, '..', 'assets', 'mocha-logo-96.png');
-};
-
-/**
- * @summary
- * Gets platform-specific Growl support binaries.
- *
- * @description
- * Somewhat brittle dependency on `growl` package implementation, but it
- * rarely changes.
- *
- * @private
- * @see {@link https://github.com/tj/node-growl/blob/master/lib/growl.js#L28-L126|setupCmd}
- * @return {string[]} names of Growl support binaries
- */
-const getSupportBinaries = () => {
-  const binaries = {
-    Darwin: ['terminal-notifier', 'growlnotify'],
-    Linux: ['notify-send', 'growl'],
-    Windows_NT: ['growlnotify.exe']
-  };
-  return binaries[os.type()] || [];
-};
+'use strict';
+
+/**
+ * Desktop Notifications module.
+ * @module Growl
+ */
+
+const os = require('os');
+const path = require('path');
+const {sync: which} = require('which');
+const {EVENT_RUN_END} = require('./runner').constants;
+
+/**
+ * @summary
+ * Checks if Growl notification support seems likely.
+ *
+ * @description
+ * Glosses over the distinction between an unsupported platform
+ * and one that lacks prerequisite software installations.
+ *
+ * @public
+ * @see {@link https://github.com/tj/node-growl/blob/master/README.md|Prerequisite Installs}
+ * @see {@link Mocha#growl}
+ * @see {@link Mocha#isGrowlCapable}
+ * @return {boolean} whether Growl notification support can be expected
+ */
+exports.isCapable = () => {
+  if (!process.browser) {
+    return getSupportBinaries().reduce(
+      (acc, binary) => acc || Boolean(which(binary, {nothrow: true})),
+      false
+    );
+  }
+  return false;
+};
+
+/**
+ * Implements desktop notifications as a pseudo-reporter.
+ *
+ * @public
+ * @see {@link Mocha#_growl}
+ * @param {Runner} runner - Runner instance.
+ */
+exports.notify = runner => {
+  runner.once(EVENT_RUN_END, () => {
+    display(runner);
+  });
+};
+
+/**
+ * Displays the notification.
+ *
+ * @private
+ * @param {Runner} runner - Runner instance.
+ */
+const display = runner => {
+  const growl = require('growl');
+  const stats = runner.stats;
+  const symbol = {
+    cross: '\u274C',
+    tick: '\u2705'
+  };
+  let _message;
+  let message;
+  let title;
+
+  if (stats.failures) {
+    _message = `${stats.failures} of ${stats.tests} tests failed`;
+    message = `${symbol.cross} ${_message}`;
+    title = 'Failed';
+  } else {
+    _message = `${stats.passes} tests passed in ${stats.duration}ms`;
+    message = `${symbol.tick} ${_message}`;
+    title = 'Passed';
+  }
+
+  // Send notification
+  const options = {
+    image: logo(),
+    name: 'mocha',
+    title
+  };
+  growl(message, options, onCompletion);
+};
+
+/**
+ * @summary
+ * Callback for result of attempted Growl notification.
+ *
+ * @description
+ * Despite its appearance, this is <strong>not</strong> an Error-first
+ * callback -- all parameters are populated regardless of success.
+ *
+ * @private
+ * @callback Growl~growlCB
+ * @param {*} err - Error object, or <code>null</code> if successful.
+ */
+function onCompletion(err) {
+  if (err) {
+    // As notifications are tangential to our purpose, just log the error.
+    const message =
+      err.code === 'ENOENT' ? 'prerequisite software not found' : err.message;
+    console.error('notification error:', message);
+  }
+}
+
+/**
+ * Returns Mocha logo image path.
+ *
+ * @private
+ * @return {string} Pathname of Mocha logo
+ */
+const logo = () => {
+  return path.join(__dirname, '..', 'assets', 'mocha-logo-96.png');
+};
+
+/**
+ * @summary
+ * Gets platform-specific Growl support binaries.
+ *
+ * @description
+ * Somewhat brittle dependency on `growl` package implementation, but it
+ * rarely changes.
+ *
+ * @private
+ * @see {@link https://github.com/tj/node-growl/blob/master/lib/growl.js#L28-L126|setupCmd}
+ * @return {string[]} names of Growl support binaries
+ */
+const getSupportBinaries = () => {
+  const binaries = {
+    Darwin: ['terminal-notifier', 'growlnotify'],
+    Linux: ['notify-send', 'growl'],
+    Windows_NT: ['growlnotify.exe']
+  };
+  return binaries[os.type()] || [];
+};

package/lib/hook.js

@@ -1,46 +1,46 @@
-'use strict';
-
-var Runnable = require('./runnable');
-var inherits = require('./utils').inherits;
-
-/**
- * Expose `Hook`.
- */
-
-module.exports = Hook;
-
-/**
- * Initialize a new `Hook` with the given `title` and callback `fn`
- *
- * @class
- * @extends Runnable
- * @param {String} title
- * @param {Function} fn
- */
-function Hook(title, fn) {
-  Runnable.call(this, title, fn);
-  this.type = 'hook';
-}
-
-/**
- * Inherit from `Runnable.prototype`.
- */
-inherits(Hook, Runnable);
-
-/**
- * Get or set the test `err`.
- *
- * @memberof Hook
- * @public
- * @param {Error} err
- * @return {Error}
- */
-Hook.prototype.error = function(err) {
-  if (!arguments.length) {
-    err = this._error;
-    this._error = null;
-    return err;
-  }
-
-  this._error = err;
-};
+'use strict';
+
+var Runnable = require('./runnable');
+var inherits = require('./utils').inherits;
+
+/**
+ * Expose `Hook`.
+ */
+
+module.exports = Hook;
+
+/**
+ * Initialize a new `Hook` with the given `title` and callback `fn`
+ *
+ * @class
+ * @extends Runnable
+ * @param {String} title
+ * @param {Function} fn
+ */
+function Hook(title, fn) {
+  Runnable.call(this, title, fn);
+  this.type = 'hook';
+}
+
+/**
+ * Inherit from `Runnable.prototype`.
+ */
+inherits(Hook, Runnable);
+
+/**
+ * Get or set the test `err`.
+ *
+ * @memberof Hook
+ * @public
+ * @param {Error} err
+ * @return {Error}
+ */
+Hook.prototype.error = function(err) {
+  if (!arguments.length) {
+    err = this._error;
+    this._error = null;
+    return err;
+  }
+
+  this._error = err;
+};

package/lib/interfaces/bdd.js

@@ -1,118 +1,118 @@
-'use strict';
-
-var Test = require('../test');
-var EVENT_FILE_PRE_REQUIRE = require('../suite').constants
-  .EVENT_FILE_PRE_REQUIRE;
-
-/**
- * BDD-style interface:
- *
- *      describe('Array', function() {
- *        describe('#indexOf()', function() {
- *          it('should return -1 when not present', function() {
- *            // ...
- *          });
- *
- *          it('should return the index when present', function() {
- *            // ...
- *          });
- *        });
- *      });
- *
- * @param {Suite} suite Root suite.
- */
-module.exports = function bddInterface(suite) {
-  var suites = [suite];
-
-  suite.on(EVENT_FILE_PRE_REQUIRE, function(context, file, mocha) {
-    var common = require('./common')(suites, context, mocha);
-
-    context.before = common.before;
-    context.after = common.after;
-    context.beforeEach = common.beforeEach;
-    context.afterEach = common.afterEach;
-    context.run = mocha.options.delay && common.runWithSuite(suite);
-    /**
-     * Describe a "suite" with the given `title`
-     * and callback `fn` containing nested suites
-     * and/or tests.
-     */
-
-    context.describe = context.context = function(title, fn) {
-      return common.suite.create({
-        title: title,
-        file: file,
-        fn: fn
-      });
-    };
-
-    /**
-     * Pending describe.
-     */
-
-    context.xdescribe = context.xcontext = context.describe.skip = function(
-      title,
-      fn
-    ) {
-      return common.suite.skip({
-        title: title,
-        file: file,
-        fn: fn
-      });
-    };
-
-    /**
-     * Exclusive suite.
-     */
-
-    context.describe.only = function(title, fn) {
-      return common.suite.only({
-        title: title,
-        file: file,
-        fn: fn
-      });
-    };
-
-    /**
-     * Describe a specification or test-case
-     * with the given `title` and callback `fn`
-     * acting as a thunk.
-     */
-
-    context.it = context.specify = function(title, fn) {
-      var suite = suites[0];
-      if (suite.isPending()) {
-        fn = null;
-      }
-      var test = new Test(title, fn);
-      test.file = file;
-      suite.addTest(test);
-      return test;
-    };
-
-    /**
-     * Exclusive test-case.
-     */
-
-    context.it.only = function(title, fn) {
-      return common.test.only(mocha, context.it(title, fn));
-    };
-
-    /**
-     * Pending test case.
-     */
-
-    context.xit = context.xspecify = context.it.skip = function(title) {
-      return context.it(title);
-    };
-
-    /**
-     * Number of attempts to retry.
-     */
-    context.it.retries = function(n) {
-      context.retries(n);
-    };
-  });
-};
-
-module.exports.description = 'BDD or RSpec style [default]';
+'use strict';
+
+var Test = require('../test');
+var EVENT_FILE_PRE_REQUIRE = require('../suite').constants
+  .EVENT_FILE_PRE_REQUIRE;
+
+/**
+ * BDD-style interface:
+ *
+ *      describe('Array', function() {
+ *        describe('#indexOf()', function() {
+ *          it('should return -1 when not present', function() {
+ *            // ...
+ *          });
+ *
+ *          it('should return the index when present', function() {
+ *            // ...
+ *          });
+ *        });
+ *      });
+ *
+ * @param {Suite} suite Root suite.
+ */
+module.exports = function bddInterface(suite) {
+  var suites = [suite];
+
+  suite.on(EVENT_FILE_PRE_REQUIRE, function(context, file, mocha) {
+    var common = require('./common')(suites, context, mocha);
+
+    context.before = common.before;
+    context.after = common.after;
+    context.beforeEach = common.beforeEach;
+    context.afterEach = common.afterEach;
+    context.run = mocha.options.delay && common.runWithSuite(suite);
+    /**
+     * Describe a "suite" with the given `title`
+     * and callback `fn` containing nested suites
+     * and/or tests.
+     */
+
+    context.describe = context.context = function(title, fn) {
+      return common.suite.create({
+        title: title,
+        file: file,
+        fn: fn
+      });
+    };
+
+    /**
+     * Pending describe.
+     */
+
+    context.xdescribe = context.xcontext = context.describe.skip = function(
+      title,
+      fn
+    ) {
+      return common.suite.skip({
+        title: title,
+        file: file,
+        fn: fn
+      });
+    };
+
+    /**
+     * Exclusive suite.
+     */
+
+    context.describe.only = function(title, fn) {
+      return common.suite.only({
+        title: title,
+        file: file,
+        fn: fn
+      });
+    };
+
+    /**
+     * Describe a specification or test-case
+     * with the given `title` and callback `fn`
+     * acting as a thunk.
+     */
+
+    context.it = context.specify = function(title, fn) {
+      var suite = suites[0];
+      if (suite.isPending()) {
+        fn = null;
+      }
+      var test = new Test(title, fn);
+      test.file = file;
+      suite.addTest(test);
+      return test;
+    };
+
+    /**
+     * Exclusive test-case.
+     */
+
+    context.it.only = function(title, fn) {
+      return common.test.only(mocha, context.it(title, fn));
+    };
+
+    /**
+     * Pending test case.
+     */
+
+    context.xit = context.xspecify = context.it.skip = function(title) {
+      return context.it(title);
+    };
+
+    /**
+     * Number of attempts to retry.
+     */
+    context.it.retries = function(n) {
+      context.retries(n);
+    };
+  });
+};
+
+module.exports.description = 'BDD or RSpec style [default]';