TRAX LRS comes with a set of unit tests which can be run to check that your LRS is up and running, and that there is no regression after an update.
Before running the tests:
.env.testing
file (a copy of .env
with the right DB settings).{danger} Be sure to deactivate your config cache before running the tests:
php artisan config:clear
. Otherwise your current database will be deleted and used for the unit tests!
Then you can run all the tests:
vendor/bin/phpunit
You can run one of the 3 sets of tests:
vendor/bin/phpunit --testsuite auth
vendor/bin/phpunit --testsuite repo
vendor/bin/phpunit --testsuite xapi-store
You can run a given test file. For example:
vendor/bin/phpunit services/trax/test/auth/AuthenticationTest.php
You can run a given function inside a test file. For example:
vendor/bin/phpunit services/trax/test/auth/AuthenticationTest.php --filter testClientNoAuth
ADL provides an LRS Conformance Test Suite to check that an LRS is xAPI conformant. TRAX LRS passed this test and we use it on a regular basis to check that there is no regression. Please, refer to the ADL documentation if you want to run this test.