PHPackages pragmarx/ci - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Testing & Quality](/categories/testing) 4. / 5. pragmarx/ci Abandoned → [pragmarx/tddd](/?search=pragmarx%2Ftddd)Library[Testing & Quality](/categories/testing) pragmarx/ci =========== A Self-Hosted TDD Dashboard & Tests Watcher v0.10.0(7y ago)7171.4k↓100%55[8 issues](https://github.com/antonioribeiro/ci/issues)MITVuePHP >=7.0 Since Nov 24Pushed 2y ago27 watchersCompare [ Source](https://github.com/antonioribeiro/ci)[ Packagist](https://packagist.org/packages/pragmarx/ci)[ RSS](/packages/pragmarx-ci/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (11)Versions (20)Used By (0) TDDD - Test Driven Development Dashboard ======================================== [](#tddd---test-driven-development-dashboard) ### A Self-Hosted TDD Dashboard & Tests Watcher [](#a-self-hosted-tdd-dashboard--tests-watcher) [![Latest Stable Version](https://camo.githubusercontent.com/98b76f5a0bbed744b80e4bc4eaf729b805f02d00d2a55b673885f5d22d4a8044/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f707261676d6172782f746464642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pragmarx/tddd)[![License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Downloads](https://camo.githubusercontent.com/3052f3f6d6f80ec860be647a498132c1b969604337863583678b26dbdc7238bd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f707261676d6172782f746464642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pragmarx/tddd)[![Code Quality](https://camo.githubusercontent.com/01425325f358880bc957351667d656fcb5d33361cc314d8d1164b7bd4be1ca08/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f616e746f6e696f7269626569726f2f746464642e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-tddd.com/g/antonioribeiro/tddd/?branch=master)[![Build](https://camo.githubusercontent.com/969737025c3d9f2e7a03e58b668d44b78f5ccec7a6209b394646d1c93cc89cf0/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f616e746f6e696f7269626569726f2f746464642e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-tddd.com/g/antonioribeiro/tddd/?branch=master)[![StyleCI](https://camo.githubusercontent.com/f5010813464878bdde66d78559f9ee791ffb659c6062c265ac961edca6acd38f/68747470733a2f2f7374796c6563692e696f2f7265706f732f32373033373737392f736869656c64)](https://styleci.io/repos/27037779) What is it? ----------- [](#what-is-it) TDD Dashboard, is an app (built as a Laravel PHP package) to watch and run all your tests during development. It supports any test framework working on terminal, and comes with some testers (PHPUnit, phpspec, behat, Jest, AVA...) preconfigured, but you can easily add yours, just tell it where the executable is and it's done. It 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.) going right to 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. It uses Laravel as motor, but supports (and has been tested with) many languages, frameworks and testing frameworks: - [PHPUnit](https://phpunit.de/) - [Laravel & Laravel Dusk](https://laravel.com/docs/5.5/dusk) - [Codeception](http://codeception.com/) - [phpspec](http://www.phpspec.net/en/stable/) - [Behat](http://behat.org/en/latest/) - [atoum](http://atoum.org/) - [Jest](https://facebook.github.io/jest/) - [AVA](https://github.com/avajs/ava) - [React](https://reactjs.org/) - [Ruby on Rails](http://guides.rubyonrails.org/testing.html) - [Nette Tester](https://tester.nette.org/) - [Symfony](https://symfony.com/doc/current/testing.html) Features -------- [](#features) - 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. - Highly configurable, watch anything and test everything! ### Videos [](#videos) - [Preview](https://www.youtube.com/watch?v=sO_aDf3xCgE) - [Installing](https://youtu.be/AgkKCLNiV8w) - [VueJS Preview](https://youtu.be/HAdfLYArk_A) - [Laravel Dusk Preview](https://youtu.be/ooF4oLD9U7Q) ### Screenshots [](#screenshots) #### Dashboard [](#dashboard) [![visits](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/dashboard.png)](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/dashboard.png) #### Error Log [](#error-log) [![visits](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog1.png)](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog1.png) [![visits](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog2.png)](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog2.png) [![visits](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog3.png)](https://raw.githubusercontent.com/antonioribeiro/tddd/master/docs/errorlog3.png) Command Line Interface ---------------------- [](#command-line-interface) The Artisan commands **Watcher** and **Tester** are responsible for watching resources and firing tests, respectively: ### Watcher [](#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 tddd:watch ``` ### Tester [](#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 tddd:test ``` ### Notifications [](#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 ---------------------------- [](#test-framework-compatibility) This package was tested and is known to be compatible with - [Codeception](http://codeception.com/) - [PHPUnit](https://phpunit.de/) - [phpspec](http://www.phpspec.net/) - [behat](http://docs.behat.org/) - [atoum](https://github.com/atoum/atoum) - [Nette Tester](http://tester.nette.org/en/) Installing ---------- [](#installing) #### TL;DR [](#tldr) ``` laravel new tddd cd tddd composer require pragmarx/tddd php artisan vendor:publish --provider="PragmaRX\Tddd\Package\ServiceProvider" valet link tddd # configure database on your .env php artisan migrate php artisan tddd:watch & php artisan tddd:work & open http://tddd.dev/tests-watcher/dashboard ``` ### Examples & Starter App [](#examples--starter-app) For lots of examples, check [this starter app](https://github.com/antonioribeiro/tests-watcher-starter), which will also help you create an independent dashboard for your tests. ### The long version [](#the-long-version) Require it with [Composer](http://getcomposer.org/): ``` composer require pragmarx/tddd ``` 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\Tddd\Package\ServiceProvider', ``` ``` php artisan config:publish pragmarx/tddd ``` On Laravel 5.\* ``` php artisan vendor:publish --provider="PragmaRX\Tddd\Package\ServiceProvider" ``` Example of projects ------------------- [](#example-of-projects) ### Laravel Dusk [](#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 --------------- [](#troubleshooting) #### Tests are running fine in terminal but failing in the dashboard? [](#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 your results. Requirements ------------ [](#requirements) - Laravel 4.1+ or 5 - PHP 5.3.7+ Author ------ [](#author) [Antonio Carlos Ribeiro](http://twitter.com/iantonioribeiro) License ------- [](#license) Laravel Ci is licensed under the BSD 3-Clause License - see the `LICENSE` file for details Contributing ------------ [](#contributing) Pull requests and issues are welcome. ### Health Score 38 — LowBetter than 85% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity39 Limited adoption so far Community25 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 96.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~81 days Recently: every ~67 days Total 18 Last Release 2808d ago PHP version history (3 changes)v0.1.0PHP >=5.4.0 v0.9.0PHP >=5.4 v0.9.5PHP >=7.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/d9421a69d192db597169ec3519ad3efc6a35a660e4525e2ed08f6c753b908e86?d=identicon)[AntonioCarlosRibeiro](/maintainers/AntonioCarlosRibeiro) --- Top Contributors [![antonioribeiro](https://avatars.githubusercontent.com/u/3182864?v=4)](https://github.com/antonioribeiro "antonioribeiro (357 commits)")[![stltt](https://avatars.githubusercontent.com/u/509567?v=4)](https://github.com/stltt "stltt (9 commits)")[![bagwaa](https://avatars.githubusercontent.com/u/825428?v=4)](https://github.com/bagwaa "bagwaa (1 commits)")[![brysonreece](https://avatars.githubusercontent.com/u/4043157?v=4)](https://github.com/brysonreece "brysonreece (1 commits)")[![sumityadav](https://avatars.githubusercontent.com/u/169143?v=4)](https://github.com/sumityadav "sumityadav (1 commits)")[![bryant1410](https://avatars.githubusercontent.com/u/3905501?v=4)](https://github.com/bryant1410 "bryant1410 (1 commits)")[![arie-piscator](https://avatars.githubusercontent.com/u/9989186?v=4)](https://github.com/arie-piscator "arie-piscator (1 commits)") --- Tags codeceptiondashboarddeveloper-toolslaravellaravel-duskphpphpspecphpunittestertestingwatchertestingphpunittestlaravelcodeceptionBDDTDDcontinuous integrationBehatciphpspecwatcheratoumtestertest-driven-developmentdusk ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/pragmarx-ci/health.svg) ``` [![Health](https://phpackages.com/badges/pragmarx-ci/health.svg)](https://phpackages.com/packages/pragmarx-ci) ``` ### Alternatives [orchestra/testbench Laravel Testing Helper for Packages Development 2.2k39.1M32.1k](/packages/orchestra-testbench)[php-mock/php-mock-phpunit Mock built-in PHP functions (e.g. time()) with PHPUnit. This package relies on PHP's namespace fallback policy. No further extension is needed. 1718.2M399](/packages/php-mock-php-mock-phpunit)[orchestra/workbench Workbench Companion for Laravel Packages Development 8017.0M43](/packages/orchestra-workbench)[benconstable/phpspec-laravel Test your Laravel applications with PhpSpec 144347.1k15](/packages/benconstable-phpspec-laravel)[code-distortion/adapt A Laravel package that builds databases for your tests, improving their speed. 2835.5k](/packages/code-distortion-adapt)[sofa/laravel-kahlan Kahlan specs suite for testing Laravel applications 1524.2k](/packages/sofa-laravel-kahlan) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)