sintonia/docs/TESTING.md

Testing LibreTime

MVC

The MVC tests are based on PHPUnit and may be found in airtime_mvc/tests.

You can run the tests in you working copy as described below or let travis run them for you on pushes.

Prepare environment

PHPUnit will need to be able to access the database and be allowed to create the libretime_test database. On a clean install this may be set up as follows.

psql -c 'CREATE DATABASE libretime;' -U postgres -h localhost
psql -c "CREATE USER libretime WITH PASSWORD 'libretime';" -U postgres -h localhost
psql -c 'GRANT CONNECT ON DATABASE libretime TO libretime;' -U postgres -h localhost
psql -c 'ALTER USER libretime CREATEDB;' -U postgres -h localhost

In this case the libretime database is only used for the initial connection over which the libretime_test database is created.

Install PHPUnit

PHPUnit should have already been installed when you ran composer install.

If you have not done so, now is the time to do so.

Run the tests

# run all tests
cd airtime_mvc/tests
../../vendor/bin/phpunit

# run a subset of tests
../../vendor/bin/phpunit --filter testEditReatingShowInstance