pragmarx/ci

A Test Driven Development Dashboard Package

Thursday, December 7, 2017
by AntonioCarlosRibeiro
Repository
32 Watchers
601 Stars
1,245 Installations

PHP
0 Dependents
0 Suggesters
47 Forks
6 Open issues
16 Versions
0 % Grown

The README.md

TDDD - Test Driven Development Dashboard

A Self-Hosted TDD Dashboard & Tests Watcher

, _(*1)

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., _(*2)

It uses Laravel as motor, but supports (and has been tested with) many languages, frameworks and testing frameworks:, _(*3)

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

Screenshots

Dashboard

visits , _(*4)

Error Log

visits , _(*5)

visits , _(*6)

visits , _(*7)

Command Line Interface

The Artisan commands Watcher and Tester are responsible for watching resources and firing tests, respectively:, _(*8)

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:, _(*9)

``` bash php artisan tddd:watch, _(*10)


### 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:

``` bash
php artisan tddd:test

Notifications

It uses JoliNotif, so if it's not working on macOS, you can try installing terminal-notifier:, _(*11)

``` bash brew install terminal-notifier, _(*12)


## 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

#### TL;DR

``` bash
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

For lots of examples, check this starter app, which will also help you create an independent dashboard for your tests., _(*13)

The long version

Require it with Composer:, _(*14)

``` bash composer require pragmarx/tddd, _(*15)


Create a database, configure on your Laravel app and migrate it

``` bash
php artisan migrate

Publish Ci configuration:, _(*16)

On Laravel 4.*, _(*17)

Add the service provider to your app/config/app.php:, _(*18)

``` php 'PragmaRX\Tddd\Package\ServiceProvider',, _(*19)


``` bash
php artisan config:publish pragmarx/tddd

On Laravel 5.*, _(*20)

``` bash php artisan vendor:publish --provider="PragmaRX\Tddd\Package\ServiceProvider", _(*21)


## Example of projects

### Laravel Dusk

``` php
'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 your results., _(*22)

Requirements

Laravel 4.1+ or 5
PHP 5.3.7+

Author

Antonio Carlos Ribeiro, _(*23)

License

Laravel Ci is licensed under the BSD 3-Clause License - see the LICENSE file for details, _(*24)

Contributing

Pull requests and issues are welcome., _(*25)

The Versions

07/12 2017

dev-master

9999999-dev

A Test Driven Development Dashboard Package

library ci

A Test Driven Development Dashboard Package

pragmarx/ci

The README.md

TDDD - Test Driven Development Dashboard

A Self-Hosted TDD Dashboard & Tests Watcher

What is it?

Features

Videos

Screenshots

Dashboard

Error Log

Command Line Interface

Watcher

Notifications

Examples & Starter App

The long version

Troubleshooting

Tests are running fine in terminal but failing in the dashboard?

Requirements

Author

License

Contributing

The Versions

dev-master

The Requires

The Development Requires

by Antonio Carlos Ribeiro

dev-docker

The Requires

The Development Requires

by Antonio Carlos Ribeiro

dev-analysis-8609gM

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.5

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.4

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.3

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.2

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.1

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.9.0

The Requires

The Development Requires

by Antonio Carlos Ribeiro

v0.5.0

The Requires

by Antonio Carlos Ribeiro

v0.1.5

The Requires

by Antonio Carlos Ribeiro

v0.1.4

The Requires

by Antonio Carlos Ribeiro

v0.1.3

The Requires

by Antonio Carlos Ribeiro

v0.1.2

The Requires

by Antonio Carlos Ribeiro

v0.1.1

The Requires

by Antonio Carlos Ribeiro

v0.1.0

The Requires