[[PHPUnitToc]]
= PHP-GTK2 Test Runner screen shots =

== Startup ==

Directly after starting, the GTK Testrunner looks like this:

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_startup.png)]]

You should the use the "File" menu for either opening a single test suite or for searching your project for your test suite files, to load multiple of them.

== Open file ==

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_fileopen.png)]]

The file open dialog allows you to select a PHP source code file, which should contain a class declaration that extends PHPUnit_Framework_TestSuite. The selected file will then be required and all found test suites will be displayed in the main window, so you can select them for being run.

== Find files ==

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_filefind.png)]]

Since your project most propably contains multiple test suites, you can use the file find dialog to find all of the them and select multiple of them for being loaded.

== A loaded test suite ==

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_loadedsuite.png)]]

Once you loaded a test suite, the main window will display it in a tree view. You can either select the whole suite, any of its sub-suites or single test cases for being run.

== Running tests ==

As soon as you have selected test cases for running, you can start the test run by clicking the "Run" button.

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_runningsuite.png)]]

The GTK UI will indicate the progress of your tests in a progress bar and add status information about each test case to the status window, as soon as it starts running the tests case. Beside that, an icon in the suite tree indicates the status of the test.

== Viewing details ==

The status tree contains a large bunch of information after a test run. To directly jump to the last status information of a certain test case, simple double click it in the suite tree.

[[Image(http://static.phpunit.de/gtkui/PHPUnit_PHP-GTK2_Testrunner_failedtest.png)]]