Installation

The plugin is installable via the SonarQube Marketplace in the Administration settings.

For a manual installation copy the plugin jar into extensions/plugin directory and restart the server.

Setup

General Settings

These steps are optional

Under Administration > Configuration > Mutation Analyis you may configure:

• Active Pitest Sensor - turn the sensor on or off (default: on)
• Effort Factor: Missing Coverage - configure the factor for calculating tbe total effort to add more coverage (default is 1.0)
• Effort Factor: Survived Mutant - configure the factor for calculating tbe total effort to kill a survived mutant (default is 1.0)
• Effort: Kill a mutant - configure the base effort to kill a mutant (default is 15min)
• Enable Experimental Features - Some of the newer features are in experimental state and are disabled by default. These feature are not yet fully tested both in automated tests and practice. Activating these feature might break the analysis but may also provide additional insights into your code.
• Output directory for the PIT reports the subdirectory of a maven project where the pitest report is located (default: target/pit-reports)

The effort settings are used to calculate the effort to decrease the technical debt. The default values are arbitrary and are not based on any empirical research.

Quality Profile

In order to run a Mutation Analysis a profile with mutation analysis specific rules enable must be used.

The plugin contains a built-in quality profile, that contains all mutator-specific rules.

If you're using custom profile, you may activate the Mutation Capabilities by adding the mutator rules to the profile:

0. Optional: Create a new custom profile or create a copy of an existing profile
1. Edit your profile
2. In the rules box, click on "Activate More"
3. In the search:
   1. Select Repository Mutation Analysis
   2. Select Tag mutation-operator (maybe you have to search for it)
   3. Click on Bulk change
   4. Activate in your profile