schlitt.info - php, photography and private stuff
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

:Author: 		Tobias Schlitt
:Date:			Fri, 09 Jan 2009 12:34:32 +0100
:Revision: 		2
:Copyright:		CC by-nc-sa


=====================
A GTK2 UI for PHPUnit
=====================

:Description:
    For my current exam phase at university, I wanted to have some tiny
    project where I can play around with, without caring too much, just to
    relax a bit in the evenings. When Kore infected me with some strange
    PHP-GTK virus ;) and someone mentioned on IRC, that it would be time to
    have a GTK UI for PHPUnit, I decided to take this one. So I played some
    hours with the PHP-GTK extension and voila, here we go with a first
    running version of a GTK driven test runner for PHPUnit.

For my current exam phase at university, I wanted to have some tiny project
where I can play around with, without caring too much, just to relax a bit in
the evenings. When `Kore`__ infected me with some strange `PHP-GTK`__ virus ;)
and someone mentioned on IRC, that it would be time to have a GTK UI for
`PHPUnit`__, I decided to take this one. So I played some hours with the
PHP-GTK extension and voila, here we go with a first running version of a GTK
driven test runner for PHPUnit.

.. __: http://kore-nordmann.de
.. __: http://gtk.php.net
.. __: http://www.phpunit.de

|image_1|

.. |image_1| image:: http://files.schlitt.info/misc/PHPUnit-GTK2/PHPUnit_PHP-GTK2_Testrunner_failedtest.png
   :target: http://www.phpunit.de/wiki/GtkUIScreenshots

More screenshots can be found `here`__

.. __: http://www.phpunit.de/wiki/GtkUIScreenshots

Since yesterday, the project is officially available through the `PHPUnit
SVN`__ and (according to `Sebastian`__) is planned to be part of the PHPUnit
release 3.2. So far, it ist in absolute alpha stage and still misses a lot of
features and might propably not run too stable on your system. At least it
does on mine, so far.

.. __: http://www.phpunit.de/browser/phpunit/branches/3.2/PHPUnit/GtkUI
.. __: http://sebastian-bergmann.de

By now, the GUI allows you to load single or multiple PHPUnit tests suites
(starting with version 3.0 of PHPUnit), to run them and display their results.
If you want to try it out, you can either check it out from the `PHPUnit
SVN`__ or `download a recent tarball`__.

.. __: http://www.phpunit.de/browser/phpunit/branches/3.2/PHPUnit/GtkUI
.. __: http://files.schlitt.info/misc/PHPUnit-GTK2/PHPUnit-GtkUI-alpha1.tar.bz2

To get the GTK UI running, you (of course) need a recent build of the
`PHP-GTK2 extension`__, `PHP >= 5.1`__ and the provided "GtkUI/" directory in
your PHPUnit installation. If your include_path directive is set correctly,
you only need to run

.. __: http://gtk.php.net/download.php
.. __: http://php.net/downloads.php#v5

::

    
    $ php /your/path/to/PHPUnit/GtkUI/Main.php

I so far tried out the UI with running the `eZ Components`__ test suites, for
which I need to have the eZ Components autoload in place. If you need
autoloading for your test suites, too, you can simply provide a PHP file
containing your __autoload() function as a parameter to the main script. Later
this will propably be configurable in the UI itself, but so far:

.. __: http://ez.no/ezcomponents

::

    
    $ php /your/path/to/PHPUnit/GtkUI/Main.php /path/to/your/autoload.php

Feel free to try it out, comment here and/or add bug-reports and
feature-requests to the `PHPUnit issue tracker`__. And, in addtition to
`Sebastians Logo Contest for phpOpenTracker`__, I'd like to beg any of you
graphically skilled people out there, to send me some icons for the `PHPUnit
GTK2 Testrunner`__. Thanks in advance1

.. __: http://www.phpunit.de/newticket
.. __: http://sebastian-bergmann.de/archives/657-phpOpenTracker-Logo-Contest.html
.. __: http://www.phpunit.de/wiki/GtkUI


..
   Local Variables:
   mode: rst
   fill-column: 79
   End: 
   vim: et syn=rst tw=79

Trackbacks
==========

- PHP-GTK2 Testrunner for PHPUnit on Tue, 20 Feb 2007 13:33:11 +0100 in Sebastian Bergmann
  
  Tobias Schlitt has announced the development of a PHP-GTK2-based test runner
  for PHPUnit. It will be part of the upcoming PHPUnit 3.2 release (roadmap).

  Thank you, Tobias, for working on this!


Comments
========

- Antti Holvikari at Tue, 20 Feb 2007 18:33:54 +0100

  This is very cool! Now, all you need is to package this as a phar :-)

- dantleech at Tue, 19 Jun 2012 12:50:04 +0200

  This looks really usefull .. whats the status of this now?