ParaTest

The objective of ParaTest is to support parallel testing in a variety of PHP testing tools. Currently only PHPUnit is supported.

Installation

Composer

To install with composer add the following to your composer.json file:

"require": {
    "brianium/paratest": "dev-master"
}

Then run php composer.phar install The display_errors php.ini directive must be set to stderr to run the test suite.

Usage

After installation, the binary can be found at vendors/bin/paratest. Usage is as follows:

paratest [-p|--processes="..."] [-f|--functional] [-h|--help] [--phpunit="..."]
[--bootstrap="..."] [-c|--configuration="..."] [-g|--group="..."] [--log-junit="..."]
[--path="..."] [path]

Windows

Windows users be sure to use the appropriate batch files. An example being:

vendors\bin\paratest.bat --phpunit vendors\bin\phpunit.bat ...

ParaTest assumes PSR-0 for loading tests.

PHPUnit Xml Config Support

When running PHPUnit tests, ParaTest will automatically pass the phpunit.xml or phpunit.xml.dist to the phpunit runner via the --configuration switch. ParaTest also allows the configuration path to be specified manually.

ParaTest will rely on the testsuites node of phpunit's xml configuration to handle loading of suites.

The following phpunit config file is used for ParaTest's test cases.

<?xml version="1.0" encoding="UTF-8"?>
<phpunit backupGlobals="false"
         backupStaticAttributes="false"
         bootstrap="../bootstrap.php"
         colors="true"
         convertErrorsToExceptions="true"
         convertNoticesToExceptions="true"
         convertWarningsToExceptions="true"
         processIsolation="false"
         stopOnFailure="false"
         syntaxCheck="false"
        >
    <testsuites>
        <testsuite name="ParaTest Fixtures">
            <directory>./tests/</directory>
        </testsuite>
    </testsuites>
</phpunit>

Running Tests

ParaTest's test suite depends on PHPUnit being installed via composer. Make sure you run composer install after cloning.

To run unit tests: vendor/bin/phpunit --bootstrap test/bootstrap.php test/ParaTest

To run integration tests: vendor/bin/phpunit --bootstrap test/bootstrap.php it/ParaTest

To run functional tests: vendor/bin/phpunit --bootstrap test/bootstrap.php functional

There are a couple of shortcuts in the bin directory as well.

bin/test for unit tests. bin/test it for integration tests. bin/test functional for functional tests

You can run all tests at once by running phpunit from the project directory. vendor/bin/phpunit

For an example of ParaTest out in the wild check out the example.