A continuous test runner for CLI¶

English | 日本語

Version 3 | Version 2

Stagehand_TestRunner is a continuous test runner to run unit tests in CLI.

It makes unit testing in a local environment much easier and comfortable. Additionally it can easily be integrated with a continuous integration server like Jenkins. It has been designed for integration into Integrated Development Environments (IDEs), a developer can create an extension like MakeGood.

Features¶

• Runs tests when a file is saved. (Continuous Testing)
• Runs tests in the specified directory.
• Runs tests in the specified file.
• Runs only the specified tests in the specified file.
• Runs only the tests in the specified classes.
• Colors the output.
• Preloads the specified PHP script before running tests.
• Notifies test results.
• Logs test results into the specified file in the JUnit XML format.
• Prints detailed progress report.
• Stops on the first failure or error.
• Specifies the test file pattern.
• Uses a YAML-based configuration file.
• Runs the phpunit command via the testrunner command.
• Supports CakePHP, CIUnit, PHPSpec, PHPUnit, and SimpleTest.

Requirements¶

• PHP 5.3.2 or greater
• pcre
• SPL
• (optional) dom
• (optional) mbstring
• Symfony ClassLoader 2.0.0 or greater
• Symfony Config 2.0.0 or greater
• Symfony Console 2.0.0 or greater
• Symfony DependencyInjection 2.0.0 or greater
• Symfony Finder 2.0.0 or greater
• Symfony Process 2.0.0 or greater
• Stagehand_AlterationMonitor 2.0.1 or greater
• Stagehand_ComponentFactory 1.0.0 or greater
• Symfony Yaml 2.0.0 or greater
• (optional) CakePHP 1.3 or 1.2
• (optional) CIUnit v0.17
• (optional) PHPSpec 1.3.0beta
• (optional) PHPUnit 3.6.0 or greater
• (optional) SimpleTest 1.0.1 or greater
• (optional) Growl for Windows (Windows), Growl (Mac OS X), the libnotify-bin package (in Ubuntu)

Installation¶

Package	Version	Stability	Release Date	License
Stagehand_TestRunner	3.6.1	stable	2013-03-26	New BSD License	Release Notes

Stagehand_TestRunner can be installed using Composer or PEAR. The following sections explain each installation method.

Composer¶

First, add the dependency to piece/stagehand-testrunner into your composer.json file as the following:

1{
2    "require-dev": {
3        "piece/stagehand-testrunner": ">=3.6.1" 
4    }
5}

Second, update your dependencies as the following:

composer update piece/stagehand-testrunner

PEAR¶

pear config-set auto_discover 1
pear install pear.piece-framework.com/stagehand_testrunner

Documentation¶

• Release Notes

Source¶

Browse Source Code¶

Browse Source Code

Git Access¶

git clone git://github.com/piece/stagehand-testrunner.git