diff --git a/README.md b/README.md index c658e48..1f7c7b5 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ cd my-project-under-test mvn clean package org.pitest:pitest-maven:mutationCoverage ``` -All options from PIT can be used. For more details check the [the PIT documentation](https://pitest.org/quickstart/maven/). +All options from PIT can be used. For more details check [the PIT documentation](https://pitest.org/quickstart/maven/). Check ["Running Descartes on your project"](#running-descartes-on-your-project) for additional Descartes configuration options. @@ -65,7 +65,7 @@ If you use a multi-module project take a look at [PitMP](https://github.com/STAM ### Mutation testing Mutation testing allows you to verify if your test suite can detect possible bugs. The technique works by introducing small changes or faults into the original program. These modified versions are called **mutants**. -A good test suite should able to detect or *kill* a mutant. That is, at least one test case should fail when the test suite is executed with the mutant. +A good test suite should be able to detect or *kill* a mutant. That is, at least one test case should fail when the test suite is executed with the mutant. [Read more](https://en.wikipedia.org/wiki/Mutation_testing). Traditional mutation testing works at the instruction level, e.g., replacing ">" by "<=", so the number of generated mutants is huge, as the time required to check the entire test suite. That's why the authors of [Will my tests tell me if I break this code?](http://dl.acm.org/citation.cfm?doid=2896941.2896944) proposed an *Extreme Mutation* strategy, which works at the method level. @@ -399,7 +399,7 @@ PIT reporting extensions work with Descartes and include `XML`, `CSV` and `HTML` Descartes also provides three new reporting extensions: - a general reporting extension supporting `JSON` files. It works also with **Gregor**, the default mutation engine for PIT. To use just set `JSON` as report format for PIT. - a reporting extension designed for Descartes that generates a JSON file with information about pseudo and partially tested methods. To use just set `METHOD` as report format for PIT. - - Descartes can generate a human readable report containing only the list of methods with testing issues by using the `ISSUES` format. + - Descartes can generate a human-readable report containing only the list of methods with testing issues by using the `ISSUES` format. Examples of these reporting extensions for [Apache Commons-CLI](https://github.com/apache/commons-cli/tree/b9ccc94008c78a59695f0c77ebe4ecf284370956) can be checked [here](docs/examples/commons-cli). @@ -498,7 +498,7 @@ To configure the stop methods under consideration Descartes provides a `STOP_MET This feature is enabled by default. The parameter `exclude` can be used to prevent certain methods to be treated as stop methods and bring them back to the analysis. This parameter can take any of the following values: -|`exclude` | Method description | Example | +| `exclude` | Method description | Example | |-----------------|----------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------| | `empty` | `void` methods with no instruction. | `public void m() {}` | | `enum` | Methods generated by the compiler to support enum types (`values` and `valueOf`). | | @@ -553,7 +553,7 @@ The feature can be completely disabled: As said before, there are several reporting options provided by Descartes: - `JSON` for a general mutation testing report using that file format. It can be used with **Gregor**. - `METHODS` that produces a `methods.json` file with the list of all methods analyzed and categorized according to the mutation testing result. -- `ISSUES` a human readable report containing only the methods with testing issues. +- `ISSUES` a human-readable report containing only the methods with testing issues. They can be configured and combined as regular PIT report formats: diff --git a/configuration/pmd-rules.xml b/configuration/pmd-rules.xml new file mode 100644 index 0000000..4e63b26 --- /dev/null +++ b/configuration/pmd-rules.xml @@ -0,0 +1,14 @@ + + + + + Rules enforcing an accepted set of coding styles and best practices taken from PMD predefined rules. + This file customizes some of the rules to avoid false positives. + + + + + diff --git a/configuration/style.xml b/configuration/style.xml new file mode 100644 index 0000000..58e25d9 --- /dev/null +++ b/configuration/style.xml @@ -0,0 +1,380 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/examples/commons-cli/issues/index.html b/docs/examples/commons-cli/issues/index.html index 9626a80..76e20be 100644 --- a/docs/examples/commons-cli/issues/index.html +++ b/docs/examples/commons-cli/issues/index.html @@ -1,4 +1,4 @@ - + Testing issues report