/robo-paracept

Robo tasks for Codeception tests parallel execution

Primary LanguagePHPMIT LicenseMIT

robo-paracept

Build Status Latest Stable Version Total Downloads License

Robo tasks for Codeception tests parallel execution. Requires Robo Task Runner

Install via Composer

"codeception/robo-paracept":"~0.4"

Include into your RoboFile

<?php
require_once 'vendor/autoload.php';
require_once 'vendor/codeception/codeception/autoload.php';

class RoboFile extends \Robo\Tasks
{
    use \Codeception\Task\MergeReports;
    use \Codeception\Task\SplitTestsByGroups;
}
?>

PHPUnit 6 compatiblity

Add 'vendor/codeception/codeception/autoload.php' to enabled PHPUnit 6 class names:

require_once 'vendor/codeception/codeception/autoload.php';

Idea

Parallel execution of Codeception tests can be implemented in different ways. Depending on a project the actual needs can be different. Thus, we are going to prepare a set of predefined tasks that can be combined and reconfigured to fit needs.

Tasks

SplitTestsByGroups

Loads tests from a folder and distributes them between groups.

$this->taskSplitTestsByGroups(5)
    ->testsFrom('tests/acceptance')
    ->projectRoot('.')
    ->groupsTo('tests/_data/group_')
    ->run();

this command uses Codeception\Test\Loader to load tests and organize them between group. If you want just split test file and not actual tests (and not load tests into memory) you can use:

$this->taskSplitTestFilesByGroups(5)
   ->testsFrom('tests')
   ->groupsTo('tests/_data/paratest_')
   ->run();

MergeXmlReports

Mergex several XML reports:

$this->taskMergeXmlReports()
    ->from('tests/result/result1.xml')
    ->from('tests/result/result2.xml')
    ->into('tests/result/merged.xml')
    ->run();

MergeHtmlReports

Mergex several HTML reports:

$this->taskMergeHtmlReports()
    ->from('tests/result/result1.html')
    ->from('tests/result/result2.html')
    ->into('tests/result/merged.html')
    ->run();