mutastic verify

Run one mutant's tests: it passes when they catch it. How a fix is proved: each missed mutant offers it as "done when".

Usage

mutastic verify ID [DIR] [:MODULE]

The build plugins run the same command, with each option as a mutastic. property of the same name.

./gradlew mutasticVerify \
  -Pmutastic.mutant=m855c8e3c
./gradlew mutasticVerify \
  -Pmutastic.mutant=m855c8e3c \
  -p samples/pricing

mvn mutastic:verify \
  -Dmutastic.mutant=m855c8e3c
mvn mutastic:verify \
  -Dmutastic.mutant=m855c8e3c \
  -f samples/pricing

mutastic verify m855c8e3c
mutastic verify \
  m855c8e3c \
  samples/pricing

Also run this module's tests over what this one's miss: :app, or dependents for every module that depends on it.

Gradle	`-Pmutastic.testsFrom=MODULE,…` or `testsFrom = …` in `mutastic { }`
Maven	`-Dmutastic.testsFrom=MODULE,…` or `<testsFrom>…</testsFrom>` in the plugin's configuration
Command line	`--tests-from=MODULE`

./gradlew :core:mutasticRun \
  -Pmutastic.testsFrom=dependents

mutastic {
    testsFrom = listOf("dependents")
}

mvn mutastic:run \
  -Dmutastic.testsFrom=dependents \
  -pl core

<configuration>
  <testsFrom>
    <module>dependents</module>
  </testsFrom>
</configuration>

mutastic run \
  . \
  :core \
  --tests-from=dependents

How many workers run side by side; half the cores, from 1 to 4, unless set.

Gradle	`-Pmutastic.workers=N` or `workers = …` in `mutastic { }`
Maven	`-Dmutastic.workers=N` or `<workers>…</workers>` in the plugin's configuration
Command line	`--workers=N`

./gradlew mutasticRun \
  -Pmutastic.workers=2

mutastic {
    workers = 2
}

mvn mutastic:run \
  -Dmutastic.workers=2

<configuration>
  <workers>2</workers>
</configuration>

mutastic run --workers=2

Run each catching test again on its own, to confirm the catch.

Gradle	`-Pmutastic.confirmCatches` or `confirmCatches = true` in `mutastic { }`
Maven	`-Dmutastic.confirmCatches` or `<confirmCatches>true</confirmCatches>` in the plugin's configuration
Command line	`--confirm-catches`

./gradlew mutasticRun \
  -Pmutastic.confirmCatches

mutastic {
    confirmCatches = true
}

mvn mutastic:run \
  -Dmutastic.confirmCatches

<configuration>
  <confirmCatches>true</confirmCatches>
</configuration>

mutastic run --confirm-catches

Progress on stderr: a bar on a terminal, counter lines in logs, none for agents.

One of autobarcounternone