NX Stryker Mutator

Nx plugin for Stryker Mutator integration within a Nx Workspace.

Setup

Npm

npm install -D @diogovcs/stryker-mutator

Yarn

yarn add -D @diogovcs/stryker-mutator

Pnpm

pnpm add -D @diogovcs/stryker-mutator

Add to Workspace

nx generate @diogovcs/stryker-mutator:stryker-mutator [APPS_NAME] [...OPTIONS]

This command will generate stryker configuration for the projects. This plugin have presets set for node, nestjs and Angular applications. The available options allowed when generating an application are the following:

| name | type | default | description | |-----------|-----------------------------|---------|----------------------------------------------------------------------------| | APPS_NAME | string | - | Runs stryker for the projects. Accepts a comma separated list of projects. | | --preset | angular OR node OR nestjs | - | Sets different project configurations depending on the preset chosen. |

Examples

Generate stryker configurations for multiple projects:

nx generate @diogovcs/stryker-mutator:stryker-mutator my-first-project,my-second-project

Mutate

The Mutate executor can take optional parameters as the location of the stryker configuration file. Here it is an example a mutate executor configuration:

{
  "mutate": {
    "executor": "@diogovcs/stryker-mutator:mutate",
    "options": {
      "strykerConfig": "apps/my-app/stryker.config.js"
    }
  }
}

Options

| name | type | default | description | |---------------|-----------|---------|----------------------------------------------------------------------------------------------------------------------| | mutate | string | - | Specific pattern or file to mutate. (example: src/app.js or src/app.js:5-7). | | strykerConfig | string | - | Path to the stryker.config.js file. | | incremental | boolean | false | StrykerJS will track the changes you make to your code and tests and only runs mutation testing on the changed code. |