README

A Pest 4 plugin that enhances test output using Symfony Console, Termwind, and Symfony Translation.

Features

• Real-time output — test results stream to the terminal as they run, with a progress bar
• Rich colours — PASS / FAIL / WARN badges and coloured summary table
• Multi-language support — English and French built-in, simple API to add your own locale
• Zero-config opt-out — pass --no-console to fall back to the original Pest output

Requirements

• PHP ^8.3
• Pest ^4.0

Installation

composer require yukabuki/pest-plugin-console

The plugin is auto-discovered by Pest — no extra configuration needed.

Usage

Default (enhanced output)

./vendor/bin/pest

Opt out — original Pest output

./vendor/bin/pest --no-console

Change the display language

Pass --locale=XX to switch language for that run:

./vendor/bin/pest --locale=fr

Built-in locales: en (default), fr.

Add your own translation

1 — Create a translation file that returns an associative array:

// lang/de/messages.php
return [
    'section.tests'    => 'TESTS',
    'section.fail'     => 'FEHLER',
    'section.report'   => 'BERICHT',

    'badge.pass'       => 'PASS',
    'badge.fail'       => 'FAIL',
    'badge.warn'       => 'WARN',

    'table.passed'     => 'Bestanden',
    'table.failed'     => 'Fehlgeschlagen',
    'table.skipped'    => 'Übersprungen',
    'table.total'      => 'Gesamt',
    'table.assertions' => 'Assertions',
    'table.duration'   => 'Dauer',
    'table.avg'        => 'Ø',
];

2 — Register it in your tests/Pest.php bootstrap file:

// tests/Pest.php
use Yukabuki\PestPluginConsole\Translations\TranslationManager;

TranslationManager::instance()->addResourcePath(__DIR__.'/../lang/de/messages.php', 'de');

3 — Run with the locale flag:

./vendor/bin/pest --locale=de

Available translation keys

Debug — slow mode

Add a 500 ms delay between each test to inspect real-time output:

./vendor/bin/pest --slow

Contributing

Contributions are welcome. Please open an issue or submit a pull request on GitHub.

License

This package is open-sourced software licensed under the MIT license.