MakeGood

h1. A test runner for Test Driven Development

p>. English | [[ja_Overview|日本語]]

Stagehand_TestRunner provides a test runner to run unit tests. Stagehand_TestRunner strongly supports "Test Driven Development":http://en.wikipedia.org/wiki/Test-driven_development (TDD) by various features.

!phpunit-output.png!

h2. Features

* 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 test results.

* Preloads the specified PHP script before running tests.

* Monitors for changes in the specified directories and run tests when changes are detected.

* Notifies test results to "Growl":http://growl.info/.

* Logs test results into the specified file in the "JUnit":http://www.junit.org/ XML format.

* Prints detailed progress report.

* Supports "PHPUnit":http://www.phpunit.de/, "SimpleTest":http://simpletest.org/, "PHPT":http://qa.php.net/write-test.php, and "PHPSpec":http://www.phpspec.org/.

h2. Requirements

* PHP 5.2.0 or greater

* "PEAR":http://pear.php.net/package/PEAR 1.4.3 or greater

* "Stagehand_AccessControl":http://redmine.piece-framework.com/projects/show/stagehand-accesscontrol 0.1.0 or greater

* "Stagehand_AlterationMonitor":http://redmine.piece-framework.com/projects/show/stagehand-alterationmonitor 1.0.0 or greater

* "Stagehand_Autoload":http://redmine.piece-framework.com/projects/show/stagehand-autoload 0.4.0 or greater

* "Stagehand_CLIController":http://redmine.piece-framework.com/projects/show/stagehand-clicontroller 0.1.0 or greater

* "Stagehand_DirectoryScanner":http://redmine.piece-framework.com/projects/show/stagehand-directoryscanner 1.0.0 or greater

* (optional) "Console_Color":http://pear.php.net/package/Console_Color 1.0.2 or greater

* (optional) "Net_Growl":http://pear.php.net/package/Net_Growl 0.7.0 or greater

* (optional) "PHPSpec":http://www.phpspec.org/ 0.2.3 or greater

* (optional) "PHPUnit":http://www.phpunit.de/ 3.4.1 or greater

* (optional) "SimpleTest":http://simpletest.org/ 1.0.1 or greater

* "pcre":http://www.php.net/manual/en/book.pcre.php

* "SPL":http://www.php.net/manual/en/book.spl.php

* (optional) "dom":http://www.php.net/manual/en/book.dom.php

* (optional) "mbstring":http://www.php.net/manual/en/book.mbstring.php

* (optional) "xmlwriter":http://www.php.net/manual/en/book.xmlwriter.php

bq. *NOTE*: "PHPUnit":http://www.phpunit.de/ is required If you use "PHPT":http://qa.php.net/write-test.php.

h2. Installation

|_. Package |_. Version |_. Stability |_. Release Date |_. License | |

| *Stagehand_TestRunner* | *2.10.0* | stable | 2009-12-24 | "New BSD License":http://www.opensource.org/licenses/bsd-license.php | [[en_ReleaseNotes_2_10_0|Release Notes]] |

Stagehand_TestRunner can be installed directly using our PEAR channel pear.piece-framework.com. The following is a basic installation:

<pre class="prettyprint">pear channel-discover pear.piece-framework.com

pear install piece/stagehand_testrunner</pre>

h2. Documentation

* [[en_UserGuide|User Guide]]

* [[en_ReleaseNotes|Release Notes]]

h2. Source

h3. Browse Source Code

"Browse Source Code":http://github.com/piece/stagehand-testrunner

h3. Git Access

<pre class="prettyprint">git clone git://github.com/piece/stagehand-testrunner.git</pre>