Opens a new process to execute PHP on the source code passed
to the method. If you're looking for how this process can be timed
out - check the Utility/Job class which sets it internally in the
source code to be executed.
/**
* Execute the generated job which is to call the static main method.
*
* @param string $jobScript
* @return string $output
*/
public static function execute($jobScript)
{
$output = \Mutagenesis\Utility\Process::run($jobScript);
return $output;
}
/**
* @group separateprocess
*/
public function testSeparateProcessCanThrowExceptions()
{
$process = new Process();
$timeout = 120;
$autoload = realpath(__DIR__ . "/../../../vendor/autoload.php");
$job = <<<JOB
<?php
namespace MutagenesisEnv;
declare(ticks = 1);
require_once 'PHPUnit/Autoload.php';
include "{$autoload}";
class Job {
static function main () {
throw new \\Exception();
}
static function timeout() {
echo "MUTAGENESIS-TIMEOUT";
}
}
pcntl_signal(SIGALRM, array('\\MutagenesisEnv\\Job', 'timeout'), TRUE);
pcntl_alarm({$timeout});
try {
Job::main();
} catch (\\Exception \$e) {
pcntl_alarm(0);
echo "MUTAGENESIS-TIMEOUT-EXCEPTION";
}
pcntl_alarm(0);
JOB;
$return = $process->run($job);
$this->assertEquals('MUTAGENESIS-TIMEOUT-EXCEPTION', $return['stdout']);
}
/**
* Execute the generated job which is to call the static main method.
*
* @param string $jobScript
*
* @return string $output
*/
public static function execute($jobScript)
{
$output = Process::run($jobScript);
return $output;
}
/**
* Execute the runner
*
* @return void
*/
public function execute()
{
$renderer = $this->getRenderer();
echo $renderer->renderOpening();
/**
* Run the test suite once to verify it is in a passing state before
* mutations are applied. There's no point mutation testing source
* code which is already failing its tests since we'd simply get
* false positives for every single mutation applied later.
*
* This stage also logs the test run to XML/JSON since future runs will
* attempt to run the fastest test cases first (and slowest last)
* which in all probability should result in faster mutation test runs
* going forward.
*/
$result = $this->getAdapter()->runTests($this, true, true);
echo $renderer->renderPretest($result[0], $result[1]['stdout']);
/**
* If the underlying test suite is not passing, we can't continue.
*/
if ($result[0] === 'timed out' || !$result[0]) {
return;
}
/**
* Compile an array of test cases ordered by execution time in first run
* in ascending order (i.e. fastest first). Would have been logged to /tmp
* or custom cache directory by first run.
*/
//echo $renderer->renderPretestTimeAnalysisInProgress(); // TODO
$timeAnalysis = new \Mutagenesis\Utility\TestTimeAnalyser($this->getCacheDirectory() . '/mutagenesis.xml');
$orderedTestCases = $timeAnalysis->process();
$countMutants = 0;
$countMutantsKilled = 0;
$countMutantsEscaped = 0;
$mutantsEscaped = array();
$mutantsCaptured = array();
/**
* Examine all source code files and collect up mutations to apply
*/
$mutables = $this->getMutables();
/**
* Iterate across all mutations. After each, run the test suite and
* collect data on how tests handled the mutations. We use ext/runkit
* to dynamically alter included (in-memory) classes on the fly.
*/
foreach ($mutables as $i => $mutable) {
$mutations = $mutable->generate()->getMutations();
foreach ($mutations as $mutation) {
$result = $this->getAdapter()->runTests($this, false, false, $mutation, $orderedTestCases);
$output = \Mutagenesis\Utility\Process::run($job->generate($mutation, false, $orderedTestCases), $this->getTimeout());
/* TODO: Store output for per-mutant results */
$result = $this->getAdapter()->processOutput($output['stdout']);
$countMutants++;
if ($result[0] === 'timed out' || !$result[0]) {
$countMutantsKilled++;
if ($this->getDetailCaptures()) {
$mutation['mutation']->mutate($mutation['tokens'], $mutation['index']);
$mutantsCaptured[] = array($mutation, $result['stdout']);
}
} else {
$countMutantsEscaped++;
$mutation['mutation']->mutate($mutation['tokens'], $mutation['index']);
$mutantsEscaped[] = $mutation;
}
echo $renderer->renderProgressMark($result[0]);
}
$mutable->cleanup();
unset($this->_mutables[$i]);
}
/**
* Render the final report (todo: rework format sometime)
*/
echo $renderer->renderReport($countMutants, $countMutantsKilled, $countMutantsEscaped, $mutantsEscaped, $mutantsCaptured);
}