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.