<<

NAME

d4j-mutation -- run mutation analysis for a checked-out project version.

SYNOPSIS

  d4j-mutation [-w work_dir] [-r | [-t single_test] [-s test_suite]] [-i instrument_classes] [-e exclude_file] [-m mutation_operators_file]

DESCRIPTION

This script performs mutation analysis for a test or a test suite on a checked-out program version.

OPTIONS

-w work_dir

The working directory of the checked-out project version (optional). Default is the current directory.

-r

Only execute relevant developer-written tests (optional). By default all developer-written tests of the checked-out project version are executed.

-t single_test

Only run this single test method (optional). By default all tests are executed. Format: <test_class>::<test_method>.

-s test_suite

The archive file name of an external test suite (optional). The default test suite is the developer-written test suite of the checked-out project version. See Test suites.

-i instrument_classes

Mutate all classes listed in instrument_classes (optional). By default, only for the classes modified by the bug fix are mutated. The file instrument_classes must contain fully-qualified class names -- one class per line.

-e exclude_file

The file that contains the list of all mutant ids (one per row) to exclude (optional). By default no exclude file is used and therefore no mutant is excluded.

-m mutation_operators_file

The file that contains the list of mutation operators (separated by space or newline) to apply (optional). By default all mutation operators are applied: AOR, LOR, SOR, COR, ROR, ORU, LVR, STD.

Test suites

An external test suite has to be provided as an archive that contains the test sources. Format of the archive file name:

project_id-version_id-test_suite_src.test_id.tar.bz2

Examples:

<<