README

A PHPUnit results printer that outputs test results in TOON (Token-Oriented Object Notation) format.

This extension is specifically designed to provide compact, highly readable test results optimized for LLM (Large Language Model) consumption, helping AI agents quickly diagnose test failures.

Features

Compact Output: Uses TOON format to minimize token usage while remaining human-readable.
AI-Friendly Diagnostics: Includes file paths, line numbers, error messages, and stack traces for failed and errored tests.
Concise Success Reports: Passed tests only show the test name and status to keep the output focused on what needs attention.
PHPUnit Extension: Integrates seamlessly as a PHPUnit extension.

Installation

You can install the package via composer:

composer require peterfox/phpunit-toon-result-printer --dev

Configuration

Permanent (Recommended)

To use this printer, add it as an extension in your phpunit.xml or phpunit.xml.dist file:

<extensions>
    <bootstrap class="PeterFox\PhpUnitToonResultPrinter\ToonResultPrinterExtension" />
</extensions>

When enabled, it will suppress PHPUnit's default progress and result output, replacing it with TOON-formatted output at the end of the test execution.

Manual (CLI)

If you don't want to enable it for all test runs, you can trigger it manually using the --extension flag:

vendor/bin/phpunit --extension "PeterFox\PhpUnitToonResultPrinter\ToonResultPrinterExtension"

Example Output

For a passing test:

ok

For a failing test:

test: "Tests\\ExampleTest::test_it_fails"
status: failed
file: "tests/ExampleTest.php"
line: 16
message: "Failed asserting that false is true."
description: "Failed asserting that false is true."
stackTrace: "..."

Testing

composer test

Changelog

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

Credits

Peter Fox

License

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

peterfox / phpunit-toon-result-printer

Maintainers

Details