Skip to content

Rules

Jump to bottom
Gerald Mücke edited this page Jul 30, 2018 · 1 revision

The plugins contains a set of rules.

  • Generic Rules (not active by default)
    • Survived Mutants - Any mutant that is not detected but covered by a test (DEPRECATED)
    • Lurking Mutants - Any mutant that is not covered by a test(DEPRECATED)
    • Mutant with unknown Status - Any mutant for which the status could not be determined for any reason (DEPRECATED)
    • Mutation Coverage below threshold - If the Mutation Coverage of a class is below a specific threshold (default: 80%)
  • Mutation Operator specific rules (active by default)
    • Argument Propagation Mutator
    • Boolean False Return Vals Mutator
    • Boolean True Return Vals Mutator
    • Conditionals Boundary Mutator
    • Constructor Call Mutator
    • Empty Object Return Vals Mutator
    • Increments Mutator
    • Inline Constant Mutator
    • Invert Negs Mutator
    • Math Mutator
    • Negate Conditionals Mutator
    • Non Void Method Call Mutator
    • Null Return Vals Mutator
    • Primitive Returns Mutator
    • Return Vals Mutator
    • Void Method Call Mutator
    • Member Variable Mutator (Beta)
    • Naked Receiver Mutator (Beta)
    • Remove Increments Mutator (Beta)
    • Remove Switch Mutator (Beta)
    • Return Values Mutator (Beta)
    • Switch Mutator (Beta)

The Mutation Operator specific rules provide detailed information what specific mutation has not been killed and provided a description similar to the Mutator description of Pitest, which helps understanding the results without having to switch between different documentation sources.

It's not recommended to enable BOTH the generic rules for Survivors, Lurkers and Unknown Status AND the operator specific rules as this would generate lot's of duplicate issues. The generic rules (appart from the threshold rules) are likely to be removed in future releases.

If you're using these specific rules, there is no need for the Generic Rules (apart from the Mutation Coverage below threshold rule) as this would bloat the analysis result with redundant issues. It's recommended to use the mutator specific rules.

The rules marked Beta relate to Experimental rules of Pitest. It's safe to activate these rules by default as they only become effective, when you explicitly enable these mutation operators in your Pitest configuration.

Clone this wiki locally