Remove Mutant

doc/nomenclature.md

@@ -2,9 +2,58 @@
 
 ## Table of Contents
 
+- [A](#a)
+    - [AST][ast]
+- [M](#m)
+    - [Mutagenesis][mutagenesis]
+    - [Mutant][mutant]
+    - [Mutation][mutation]
+    - [Mutator][mutator]
+- [S](#s)
+    - [Subject][subject]
 - [T](#t)
-  - [Tracer][tracer]
-  - [Trace][trace]
+    - [Tracer][tracer]
+    - [Trace][trace]
+
+
+## A
+
+### AST
+
+Acronym for [Abstract Syntax Tree][ast-definition]. It is a tree representation of the abstract
+syntactic structure of code. It is what Infection parses the code into in order to operate on it.
+
+
+## M
+
+### Mutagenesis
+
+Process of creating a mutant from the original program.
+
+
+### Mutant
+
+New program that differs from the original by applying a mutation. 
+
+
+### Mutation
+
+The result of applying a mutator to the AST of a subject and represents a change to be applied.
+
+
+### Mutator
+
+Define a possible transformation, which applied to the AST of a subject will result in a mutation.
+
+In the Mutation Testing literature, mutators are also known as "mutant operator", 
+"mutagenic operator", "mutagen" and "mutation rule". 
+
+
+## S
+
+### Subject
+
+An addressable piece of code to be targeted for mutation testing.
 
 
 ## T
@@ -23,5 +72,12 @@ Artifact produced by a tracer: provides the piece of source code and its associa
 
 <hr />
 
+[ast]: #ast
+[ast-definition]: https://en.wikipedia.org/wiki/Abstract_syntax_tree
+[mutagenesis]: #mutagenesis
+[mutant]: #mutant
+[mutation]: #mutation
+[mutator]: #mutator
+[subject]: #subject
 [tracer]: #tracer
 [trace]: #trace

src/Config/ValueProvider/ExcludeDirsProvider.php

@@ -75,7 +75,7 @@ public function get(InputInterface $input, OutputInterface $output, array $dirsI
     {
         $output->writeln([
             '',
-            'There can be situations when you want to exclude some folders from generating mutants.',
+            'There can be situations when you want to exclude some folders from generating mutations.',
             'You can use glob pattern (<comment>*Bundle/**/*/Tests</comment>) for them or just regular dir path.',
             'It should be <comment>relative</comment> to the source directory.',
             '<comment>You should not mutate test suite files.</comment>',

src/Console/OutputFormatter/AbstractOutputFormatter.php

@@ -35,7 +35,7 @@
 
 namespace Infection\Console\OutputFormatter;
 
-use Infection\Mutant\MutantExecutionResult;
+use Infection\Mutation\MutationExecutionResult;
 
 /**
  * @internal
@@ -59,7 +59,7 @@ public function start(int $mutationCount): void
         $this->callsCount = 0;
     }
 
-    public function advance(MutantExecutionResult $executionResult, int $mutationCount): void
+    public function advance(MutationExecutionResult $executionResult, int $mutationCount): void
     {
         ++$this->callsCount;
     }

src/Console/OutputFormatter/DotFormatter.php

@@ -35,8 +35,8 @@
 
 namespace Infection\Console\OutputFormatter;
 
-use Infection\Mutant\DetectionStatus;
-use Infection\Mutant\MutantExecutionResult;
+use Infection\Mutation\DetectionStatus;
+use Infection\Mutation\MutationExecutionResult;
 use function Safe\sprintf;
 use function str_repeat;
 use function strlen;
@@ -71,7 +71,7 @@ public function start(int $mutationCount): void
         ]);
     }
 
-    public function advance(MutantExecutionResult $executionResult, int $mutationCount): void
+    public function advance(MutationExecutionResult $executionResult, int $mutationCount): void
     {
         parent::advance($executionResult, $mutationCount);
 

src/Console/OutputFormatter/OutputFormatter.php

@@ -35,7 +35,7 @@
 
 namespace Infection\Console\OutputFormatter;
 
-use Infection\Mutant\MutantExecutionResult;
+use Infection\Mutation\MutationExecutionResult;
 
 interface OutputFormatter
 {
@@ -47,7 +47,7 @@ public function start(int $mutationCount): void;
     /**
      * Triggered each time mutation process is finished for one Mutant
      */
-    public function advance(MutantExecutionResult $executionResult, int $mutationCount): void;
+    public function advance(MutationExecutionResult $executionResult, int $mutationCount): void;
 
     /**
      * Triggered when mutation testing is finished

src/Console/OutputFormatter/ProgressFormatter.php

@@ -35,7 +35,7 @@
 
 namespace Infection\Console\OutputFormatter;
 
-use Infection\Mutant\MutantExecutionResult;
+use Infection\Mutation\MutationExecutionResult;
 use Symfony\Component\Console\Helper\ProgressBar;
 
 /**
@@ -57,7 +57,7 @@ public function start(int $mutationCount): void
         $this->progressBar->start($mutationCount);
     }
 
-    public function advance(MutantExecutionResult $executionResult, int $mutationCount): void
+    public function advance(MutationExecutionResult $executionResult, int $mutationCount): void
     {
         parent::advance($executionResult, $mutationCount);
 

src/Container.php

@@ -62,19 +62,19 @@
 use Infection\Logger\LoggerFactory;
 use Infection\Metrics\MetricsCalculator;
 use Infection\Metrics\MinMsiChecker;
-use Infection\Mutant\MutantCodeFactory;
-use Infection\Mutant\MutantExecutionResultFactory;
-use Infection\Mutant\MutantFactory;
 use Infection\Mutation\FileMutationGenerator;
 use Infection\Mutation\Mutation;
+use Infection\Mutation\MutationCodeFactory;
+use Infection\Mutation\MutationExecutionResultFactory;
+use Infection\Mutation\MutationFactory;
 use Infection\Mutation\MutationGenerator;
 use Infection\Mutator\MutatorFactory;
 use Infection\Mutator\MutatorParser;
 use Infection\Mutator\MutatorResolver;
 use Infection\PhpParser\FileParser;
 use Infection\PhpParser\NodeTraverserFactory;
 use Infection\Process\Builder\InitialTestRunProcessBuilder;
-use Infection\Process\Builder\MutantProcessFactory;
+use Infection\Process\Builder\MutationProcessFactory;
 use Infection\Process\Builder\SubscriberBuilder;
 use Infection\Process\Runner\DryProcessRunner;
 use Infection\Process\Runner\InitialTestsRunner;
@@ -222,15 +222,15 @@ public static function create(): self
                     GeneratedExtensionsConfig::EXTENSIONS
                 );
             },
-            MutantCodeFactory::class => static function (self $container): MutantCodeFactory {
-                return new MutantCodeFactory($container->getPrinter());
+            MutationCodeFactory::class => static function (self $container): MutationCodeFactory {
+                return new MutationCodeFactory($container->getPrinter());
             },
-            MutantFactory::class => static function (self $container): MutantFactory {
-                return new MutantFactory(
+            MutationFactory::class => static function (self $container): MutationFactory {
+                return new MutationFactory(
                     $container->getConfiguration()->getTmpDir(),
                     $container->getDiffer(),
                     $container->getPrinter(),
-                    $container->getMutantCodeFactory()
+                    $container->getMutationCodeFactory()
                 );
             },
             Differ::class => static function (): Differ {
@@ -428,12 +428,12 @@ public static function create(): self
                     $container->getEventDispatcher()
                 );
             },
-            MutantProcessFactory::class => static function (self $container): MutantProcessFactory {
-                return new MutantProcessFactory(
+            MutationProcessFactory::class => static function (self $container): MutationProcessFactory {
+                return new MutationProcessFactory(
                     $container->getTestFrameworkAdapter(),
                     $container->getConfiguration()->getProcessTimeout(),
                     $container->getEventDispatcher(),
-                    $container->getMutantExecutionResultFactory()
+                    $container->getMutationExecutionResultFactory()
                 );
             },
             MutationGenerator::class => static function (self $container): MutationGenerator {
@@ -449,8 +449,8 @@ public static function create(): self
             },
             MutationTestingRunner::class => static function (self $container): MutationTestingRunner {
                 return new MutationTestingRunner(
-                    $container->getMutantProcessFactory(),
-                    $container->getMutantFactory(),
+                    $container->getMutationProcessFactory(),
+                    $container->getMutationFactory(),
                     $container->getProcessRunner(),
                     $container->getEventDispatcher(),
                     $container->getConfiguration()->isDryRun()
@@ -474,8 +474,8 @@ public static function create(): self
             AdapterInstaller::class => static function (): AdapterInstaller {
                 return new AdapterInstaller(new ComposerExecutableFinder());
             },
-            MutantExecutionResultFactory::class => static function (self $container): MutantExecutionResultFactory {
-                return new MutantExecutionResultFactory($container->getTestFrameworkAdapter());
+            MutationExecutionResultFactory::class => static function (self $container): MutationExecutionResultFactory {
+                return new MutationExecutionResultFactory($container->getTestFrameworkAdapter());
             },
         ]);
     }
@@ -643,14 +643,14 @@ public function getFactory(): Factory
         return $this->get(Factory::class);
     }
 
-    public function getMutantCodeFactory(): MutantCodeFactory
+    public function getMutationCodeFactory(): MutationCodeFactory
     {
-        return $this->get(MutantCodeFactory::class);
+        return $this->get(MutationCodeFactory::class);
     }
 
-    public function getMutantFactory(): MutantFactory
+    public function getMutationFactory(): MutationFactory
     {
-        return $this->get(MutantFactory::class);
+        return $this->get(MutationFactory::class);
     }
 
     public function getDiffer(): Differ
@@ -828,9 +828,9 @@ public function getInitialTestsRunner(): InitialTestsRunner
         return $this->get(InitialTestsRunner::class);
     }
 
-    public function getMutantProcessFactory(): MutantProcessFactory
+    public function getMutationProcessFactory(): MutationProcessFactory
     {
-        return $this->get(MutantProcessFactory::class);
+        return $this->get(MutationProcessFactory::class);
     }
 
     public function getMutationGenerator(): MutationGenerator
@@ -878,9 +878,9 @@ public function getAdapterInstaller(): AdapterInstaller
         return $this->get(AdapterInstaller::class);
     }
 
-    public function getMutantExecutionResultFactory(): MutantExecutionResultFactory
+    public function getMutationExecutionResultFactory(): MutationExecutionResultFactory
     {
-        return $this->get(MutantExecutionResultFactory::class);
+        return $this->get(MutationExecutionResultFactory::class);
     }
 
     /**

src/Engine.php

@@ -110,7 +110,7 @@ public function execute(): void
         $this->runMutationAnalysis();
 
         $this->minMsiChecker->checkMetrics(
-            $this->metricsCalculator->getTotalMutantsCount(),
+            $this->metricsCalculator->getTotalMutationsCount(),
             $this->metricsCalculator->getMutationScoreIndicator(),
             $this->metricsCalculator->getCoveredCodeMutationScoreIndicator(),
             $this->consoleOutput
@@ -155,12 +155,15 @@ private function runMutationAnalysis(): void
                 : []
         );
 
-        $actualExtraOptions = $this->config->getTestFrameworkExtraOptions();
+        $extraOptions = $this->config->getTestFrameworkExtraOptions();
 
-        $filteredExtraOptionsForMutant = $this->adapter instanceof ProvidesInitialRunOnlyOptions
-            ? $this->testFrameworkExtraOptionsFilter->filterForMutantProcess($actualExtraOptions, $this->adapter->getInitialRunOnlyOptions())
-            : $actualExtraOptions;
+        $mutationExtraOptions = $this->adapter instanceof ProvidesInitialRunOnlyOptions
+            ? $this->testFrameworkExtraOptionsFilter->filterForMutationProcess(
+                $extraOptions,
+                $this->adapter->getInitialRunOnlyOptions()
+            )
+            : $extraOptions;
 
-        $this->mutationTestingRunner->run($mutations, $filteredExtraOptionsForMutant);
+        $this->mutationTestingRunner->run($mutations, $mutationExtraOptions);
     }
 }

src/Event/MutantProcessWasFinished.php → src/Event/MutationProcessWasFinished.php

@@ -35,21 +35,21 @@
 
 namespace Infection\Event;
 
-use Infection\Mutant\MutantExecutionResult;
+use Infection\Mutation\MutationExecutionResult;
 
 /**
  * @internal
  */
-final class MutantProcessWasFinished
+final class MutationProcessWasFinished
 {
     private $executionResult;
 
-    public function __construct(MutantExecutionResult $executionResult)
+    public function __construct(MutationExecutionResult $executionResult)
     {
         $this->executionResult = $executionResult;
     }
 
-    public function getExecutionResult(): MutantExecutionResult
+    public function getExecutionResult(): MutationExecutionResult
     {
         return $this->executionResult;
     }

src/Event/Subscriber/CiMutationGeneratingConsoleLoggerSubscriber.php

@@ -55,7 +55,7 @@ public function onMutationGenerationWasStarted(MutationGenerationWasStarted $eve
     {
         $this->output->writeln([
             '',
-            'Generate mutants...',
+            'Generate mutations...',
             '',
             sprintf('Processing source code files: %s', $event->getMutableFilesCount()),
         ]);

src/Event/Subscriber/MutationGeneratingConsoleLoggerSubscriber.php

@@ -59,7 +59,7 @@ public function __construct(OutputInterface $output)
 
     public function onMutationGenerationWasStarted(MutationGenerationWasStarted $event): void
     {
-        $this->output->writeln(['', '', 'Generate mutants...', '']);
+        $this->output->writeln(['', '', 'Generate mutations...', '']);
         $this->progressBar->start($event->getMutableFilesCount());
     }