View source for Developer Area/Testing/Unit Testing

=Unit Test Introduction=
Work is currently underway to integrate phpunit unit testing in to Mahara.
Documentation for phpunit is available at http://www.phpunit.de/manual/current/en/

=Setup and Running=
You'll need to already have mahara set up and installed. Default settings are copied from your running configuration and overridden with unit test settings.

==Old instructions==

*Install phpunit on your development machine
*Switch to a user with permission to access your dataroot directory. In debian this would be:

  sudo su - www-data

*Change directory to the root of the mahara git tree (the directory that htdocs is in)

  cd $path_to_mahara

*Run phpunit, first option only if you have set up your cli for php properly:

  phpunit .
 OR
  php -c  /etc/php5/apache2/php.ini  /usr/bin/phpunit .
 OR
  php -c  /etc/php5/php-fpm/php.ini  /usr/bin/phpunit .


==New instructions==
This requires phpunit 3.7 or later which is installed by running:

 make initcomposer

Unit tests can be run by:

 make phpunit

From the main directory of mahara (eg, parent directory of htdocs)

If it complains about 'session data directory' not being writable then run as follows:

sudo -u www-data make phpunit

=Best Practices=
TODO