Tests Watcher
A Self-Hosted Continuous Testing Dashboard.
Test Watcher is a dashboard to watch & run all your tests. It supports any test framework executed via terminal: PHPUnit, Laravel Dusk, Codeception, phpspec, Jest, AVA, Behat, Atoum, rake, and you can add yours, just tell it where the executable is and it's done. Tests Watcher also shows the progress of your tests, let you run a single test or all of them, and open your favorite code editor (PHPStorm, VSCode, Sublime Text, etc.) positioning the cursor in the failing line of your test. If your test framework generate screenshots, it is also able to show it in the log page, with all the reds and greens you are used to see in your terminal.
Dashboard View
- Project List: click a project link to see all its tests.
- Open files directly in your source code editor (PHPStorm, Sublime Text...).
- Error log with source code linked, go strait to the error line in your source code.
- Enable/disable a test. Once disabled if the watcher catches a change in resources, that test will not fire.
- Real time test state: "idle", "running", "queued", "ok" and "failed".
- "Show" button, to display the error log of failed tests.
- Ready for PHPUnit, Laravel Dusk, Codeception, phpspec, atoum and more.
- Highly configurable, watch anything & test everything!
Videos
Screenshots
Dashboard
Error Log
Command Line Interface
The Artisan commands Watcher and Tester are responsible for watching resources and firing tests, respectively:
Watcher
Keep track of your files and enqueue your tests every time a project or test file is changed. If a project file changes, it will enqueue all your tests, if a test file changes, it will enqueue only that particular test. This is how you run it:
php artisan ci:watch
Tester
Responsible for taking tests from the run queue, execute it and log the results. Tester will only execute enabled tests. This is how you run it:
php artisan ci:test
Notifications
It uses JoliNotif, so if it's not working on macOS, you can try installing terminal-notifier:
brew install terminal-notifier
Test Framework Compatibility
This package was tested and is known to be compatible with
Installing
TL;DR
laravel new ci
cd ci
composer require pragmarx/ci
php artisan vendor:publish --provider="PragmaRX\TestsWatcher\Package\ServiceProvider"
valet link ci
# configure database on your .env
php artisan migrate
php artisan ci:watch & php artisan ci:work &
open http://ci.dev/tests-watcher/dashboard
Examples & Starter App
For lots of examples, check this starter app, which will also help you create an independent dashboard for your tests.
The long version
Require it with Composer:
composer require pragmarx/ci
Create a database, configure on your Laravel app and migrate it
php artisan migrate
Publish Ci configuration:
On Laravel 4.*
Add the service provider to your app/config/app.php:
'PragmaRX\TestsWatcher\Package\ServiceProvider',
php artisan config:publish pragmarx/ci
On Laravel 5.*
php artisan vendor:publish --provider="PragmaRX\TestsWatcher\Package\ServiceProvider"
Example of projects
Laravel Dusk
'project bar (dusk)' => [
'path' => $basePath,
'watch_folders' => [
'app',
'tests/Browser'
],
'exclude' => [
'tests/Browser/console/',
'tests/Browser/screenshots/',
],
'depends' => [],
'tests_path' => 'tests',
'suites' => [
'browser' => [
'tester' => 'dusk',
'tests_path' => 'Browser',
'command_options' => '',
'file_mask' => '*Test.php',
'retries' => 0,
],
],
],
Troubleshooting
Tests are running fine in terminal but failing in the dashboard?
You have first to remember they are being executed in isolation, and, also, the environment is not exactly the same, so things like a cache and session may affect yoru results.
Requirements
- Laravel 4.1+ or 5
- PHP 5.3.7+
Author
License
Laravel Ci is licensed under the BSD 3-Clause License - see the LICENSE
file for details
Contributing
Pull requests and issues are welcome.