Nuclear Pizza Machine

    This package has been deprecated

    Author message:

    For now, this project is deprecated. I no longer use or work on it, and doubt others are using it. If by any chance you were using this, and would like to see more of it in some form, let me know: justnvdm@gmail.com

    grunt-mocha-runner

    0.2.0 • Public • Published

    grunt-mocha-runner

    Serve a mocha runner page with the source and spec script paths configured in your Gruntfile.

    Getting Started

    This plugin requires Grunt ~0.4.1

    If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

    npm install grunt-mocha-runner --save-dev

    Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

    grunt.loadNpmTasks('grunt-mocha-runner');

    The mochaRunner task

    Overview

    In your project's Gruntfile, add a section named mochaRunner to the data object passed into grunt.initConfig().

    grunt.initConfig({
      mochaRunner: {
        all: {
          scripts: [
            'src/*.js',
            'test/spec/*.js'],
          styles: ['styles/*.css']
        },
      },
    })

    Options

    port

    Type: Integer Default value: 8000

    The port on which to serve the test runner.

    hostname

    Type: String Default: 'localhost'

    The hostname on which to serve the test runner.

    Setting it to '*' will make the it accessible from anywhere.

    title

    Type: String Default: 'Mocha Spec Runner'

    The title of the test runner page.

    ui

    Type: String Default: 'bdd'

    The mocha ui type to use with mocha.setup().

    Usage example

    The mochaRunner task builds and serves the mocha test runner page, but doesn't handle the actual opening of the page to run the tests. For that, we need an additional grunt task. grunt-mocha works really well for this. Here is a basic Gruntfile example showing grunt-mocha and grunt-mocha-runner being used together:

    module.exports = function (grunt) {
      grunt.loadNpmTasks('grunt-mocha');
      grunt.loadNpmTasks('grunt-mocha-runner');
     
      grunt.initConfig({
        // serves the runner page
        mochaRunner: {
          all: {
            scripts: [
              'test/app/spec/**/*.js',
              'app/scripts/**/*.js'],
          }
        },
        // opens the runner page to run the tests
        mocha: {
          options: {
            run: true,
            reporter: 'Spec',
          },
          test: {
            options: {
              // url to the runner page served by mochaRunner
              urls: ['http://localhost:8000']
            }
          }
        }
      });
     
      grunt.registerTask('test', [
        'mochaRunner',
        'mocha'
      ]);
    };

    Contributing

    In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using:

    $ grunt
    

    Keywords

    none

    Install

    npm i grunt-mocha-runner

    DownloadsWeekly Downloads

    1

    Version

    0.2.0

    License

    MIT

    Last publish

    Collaborators

    • justinvdm