README

PHPUnit Emoji Result Printer

Install

Via Composer

$ composer require coderabbi/phpumoji --dev

To enable PHPUnit emoji output, add the following two lines to the opening element of your phpunit.xml:

printerFile="vendor/coderabbi/phpumoji/src/EmojiPrinter.php"
printerClass="Coderabbi\Phpumoji\EmojiPrinter"

Usage

Usage of PHPUnit is unchanged with coderabbi/phpumoji.

Options

Select a Different Emojiset

If you wish to select an emojiset for PHPUnit emoji output, add the following additional line to the opening element of your phpunit.xml, specifying your selection:

emojiset="phpumoji"

Create a Custom Emojiset

The default emojiset is 'phpumoji'; currently that is the only emojiset available (soon, grasshopper... 😎).

If, however, you wish to create your own emojiset for PHPUnit emoji output, simply place an .emojifile in your project root and define your emojiset in the following format:

[phpumoji]
error = bomb
failure = poop
incomplete = construction
risky= game_die
skipped = see_no_evil
pass = elephant

[weird]
error = no_entry
failure = red_flag
incomplete = question
risky= clown
skipped = ghost
pass = monkey

Note that the values in the emojiset are snake-cased emoji short codes without the opening and closing colons; most existing short codes are supported, a list of supported shortcodes will be added soon.

You may choose to override one or more of the packaged emojisets (as in the case of "phumoji", above, which overrides the default emojiset), or you may define your own (as in the case of "weird", above).

Don't forget to update the opening element of your phpunit.xml with emojiset="<your_selection>", just as you would to select one of the non-default packaged emojisets.

The order of precedence is the specified emojiset in .emojifile, the specified emojiset from the packaged emojisets, the "phpumoji" emojiset from your .emojifile, and finally the the "phpumoji" emojiset from the packaged emojisets.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email coderabbi@gmail.com instead of using the issue tracker.

Credits

• Yitzchok Willroth
• All Contributors

License

The MIT License (MIT). Please see License File for more information.