atoum/autoloop-extension

Automatically run atoum's loop mode on file change

atoum/autoloop-extension

autoloop-extension allows you automatically run your tests in atoum's loop mode when files are changed., _(*1)

Example

Here is an example: we can see that the test files are automatically executed when the classes and test classes are changed., _(*2)

, _(*3)

Install it

Install extension using composer:, _(*4)

composer require --dev atoum/autoloop-extension

Then, the only thing you have to do is to set the watched files like this:, _(*5)

<?php
// .atoum.php

$runner
    ->getExtension(atoum\atoum\autoloop\extension::class)
        ->setWatchedFiles(array(__DIR__ . '/src'))
;

Use it

When the extension is loaded a new option is available:, _(*6)

--autoloop: Automatically relaunch tests on file change (implies --loop)

So, instead of launch the loop mode like this (an having to press enter each time you want to run the tests):, _(*7)

./vendor/bin/atoum --loop

Just run the tests like this:, _(*8)

./vendor/bin/atoum --autoloop

All your usual options are available., _(*9)

Tips

Notifications

This extension works well with with atoum's notification., _(*10)

//.atoum.php

$report = $script->addDefaultReport();

$notifier = new atoum\report\fields\runner\result\notifier\image\libnotify();

$notifier
    ->setSuccessImage(__DIR__ . '/vendor/atoum/atoum/resources/images/logo/success.png')
    ->setFailureImage(__DIR__ . '/vendor/atoum/atoum/resources/images/logo/failure.png')
;

$report
    ->addField($notifier)
;

With a setup like this, you will not even have to look at your console to see your test results. Here is what it looks like:, _(*11)

, _(*12)

Links

• atoum
• atoum's documentation

Licence

autoloop-extension is released under the MIT License. See the bundled LICENSE file for details., _(*13)

, _(*14)