grunt-stryker

    5.2.2 • Public • Published

    Build Status NPM Node version Slack Chat

    Grunt-stryker

    For more info on stryker, please visit stryker-mutator.io.

    Getting Started

    This plugin requires Grunt ~0.4.5 and @stryker-mutator/core ^1.0.0.

    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 using the following commands:

    npm install stryker stryker-api grunt-stryker --save-dev
    

    Once stryker and the plugin have been installed, the plugin may be enabled inside your Gruntfile with this line of JavaScript:

    grunt.loadNpmTasks('grunt-stryker');

    The "stryker" task

    Overview

    In your project's Gruntfile, add a section named stryker to the data object passed into grunt.initConfig() and then add a task. In this example we've called the task jasmine due to the fact that we plan on using the task for running Jasmine tests, but feel free to use any name you want.

    grunt.initConfig({
      stryker: {
        jasmine: {
          files: {
            libs: [/* List your library files here */],
            src: [/* List your source files here */],
            tests: [/* List your test files here */]
          },
          mutate: {
            src: [/* List the files that you want to mutate here */]
          }
        },
      },
    });

    Options

    files

    Type: Object

    An object with arrays of globbing expressions used for selecting all files needed to run the tests. These include: test files, library files, source files (the files selected with mutate) and any other file you need to run your tests. The order of the files specified here will be the order used to load the file in the test runner (karma).

    mutate

    Type: Object

    An object with arrays of globbing expressions used for selecting the files that should be mutated.

    options.configFile

    Type: string

    A location to a Stryker config file. That file should export a function which accepts a "config" object. On that object you can configure all options as an alternative for the Gruntfile. If an option is configured in both the Gruntfile and in the config file, the Gruntfile wins. An example config:

    module.exports = function(config){
      config.set({
        files: ['src/**/*.js', 'test/myFirstFile.spec.js', 'test/mySecondFile.spec.js'],
        mutate: ['src/**/*.js'],
        logLevel: 'debug'
      });
    }

    Other options

    All options will be passed through to Stryker itself. See the readme there for more info.

    Usage Examples

    Default Options

    In this example, we run mutation testing using every JavaScript file in the src folder and every file in the test folder except for test/IgnoredTestFile.js. We've called the task jasmine here due to the fact that we plan on using the task for running Jasmine tests, but feel free to use any name you want. Feel free to also choose the names of the arrays of files, we've used src and tests in this example.

    grunt.initConfig({
      stryker: {
        jasmine: {
          files: {
            src: ['src/**/*.js'],
            tests: ['test/**/*.js', '!test/IgnoredTestFile.js']
          },
          mutate: {
            src: ['src/**/*.js']
          }
        },
        options: {
            testFramework: 'jasmine',
            testRunner: 'karma'
        }
      },
    });

    Config file

    In this example, we run grunt-stryker using a config file. We could overwrite the config file by manually configuring our grunt task as well.

    // Gruntfile.js
    grunt.initConfig({
      stryker: {
        jasmine: {
          options: {
            configFile: 'stryker.conf.js'
          }
        },
      },
    });

    The content of the file stryker.conf.js in this example is:

    // stryker.conf.js
    module.exports = {
      files: [{ pattern: 'src/**/*.js', mutated: true} , 'test/myFirstFile.spec.js', 'test/mySecondFile.spec.js'],
      testFramework: 'jasmine',
      testRunner: 'karma'
    };

    Note: It's not possible to exclude files in a config file using ! like: !myFile.js. This is possible when you don't use a config file but define the options your Gruntfile. See node-glob to know what is possible.

    Supported mutations

    For the list of supported mutations, please take a look at the mutations supported by stryker

    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.

    Install

    npm i grunt-stryker

    DownloadsWeekly Downloads

    35

    Version

    5.2.2

    License

    Apache-2.0

    Unpacked Size

    42.9 kB

    Total Files

    5

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar