Infection

Infection is a PHP mutation testing framework based on Abstract Syntax Tree.

Composer

composer require --dev infection/infection

Config

It lives under the infection namespace and has following configurable parameters:

# grumphp.yml
grumphp:
    tasks:
        infection:
            threads: ~
            test_framework: ~
            only_covered: false
            show_mutations: false
            verbose: false
            configuration: ~
            min_msi: ~
            min_covered_msi: ~
            mutators: []
            ignore_patterns: []
            triggered_by: [php]
            skip_initial_tests: false
            coverage: ~

threads

Default: null

If you want to run tests for mutated code in parallel, set this to something bigger than 1. It will dramatically speed up the mutation process. Please note that if your tests somehow depends on each other or use a database, this option can lead to failing tests which give many false-positives results.

test_framework

Default: null

This is the name of a test framework to use. Currently, Infection supports PhpUnit and PhpSpec.

only_covered

Default: false

Run the mutation testing only for covered by tests files.

show_mutations

Default: false

Show escaped (and non-covered in verbose mode) mutations to the console.

verbose

Default: false

In verbose mode, non-covered escaped mutations will be shown in the console as well.

configuration

Default: null

The path or name to the infection configuration file.

min_msi

Default: null

This is a minimum threshold of Mutation Score Indicator (MSI) in percentage.

min_covered_msi

Default: null

This is a minimum threshold of Covered Code Mutation Score Indicator (MSI) in percentage.

mutators

Default: []

This is a list separated options to specify a particular set of mutators that needs to be executed.

ignore_patterns

Default: []

This is a list of patterns that will be ignored by Infection. With this option you can skip files like tests. Leave this option blank to run analysis for all 'triggered by' files.

triggered_by

Default: [php]

This option will specify which file extensions will trigger the infection task. By default, infection will be triggered by altering a php file. You can overwrite this option to whatever file you want to use!

skip_initial_tests

Default: false

Skip running the initial tests. If set to true, it is necessary to set coverage to the path where coverage-xml and log-junit is written by phpunit task.

coverage

Default: ~

Path where coverage-xml and log-junit is written by phpunit task.