tempest/testing

Test runner for Tempest

dev-main 2026-07-21 06:32 UTC

Requires

• php: ^8.5
• psr/container: ^2.0
• symfony/process: ^7.3
• tempest/console: *
• tempest/core: *
• tempest/event-bus: *

MIT

Published on Packagist.org on 2026-07-21 06:32 UTC

README

This package is an experiment in rethinking testing for PHP. It's not intended for use in real-life projects. Some of the core ideas behind this package:

✅ A fluent testing API

use Tempest\Testing\Test;

final class ArrayTest
{
    #[Test]
    public function forget_keys_mutates_array(): void
    {
        $original = [
            'foo' => 'bar',
            'baz' => 'qux',
        ];
    
        Arr\forget_keys($original, ['foo']);
    
        test($original)
            ->hasCount(1)
            ->hasKey('baz')
            ->hasNoKey('foo');
    }
}

✅ Dependency injection support

Use Tempest's container or any PSR-11 compatible one to inject dependencies into your tests.

use Tempest\Testing\Test;

final class BookTest
{
    public function __construct(
        private Database $database,
    ) {}
    
    #[Test]
    public function book_can_be_created(BookRepository $repository): void
    {
        // …
    }
}

use Tempest\Container\Initializer;
use Tempest\Container\Singleton;
use Tempest\Testing\Actions\RunTest;

final class RunTestInitializer implements Initializer
{
    #[Singleton]
    public function initialize(Container $container): RunTest
    {
    	return new RunTest(container: new YourOwnContainer());
    }
}

✅ Parallel execution

Parallel execution by default instead of an afterthought.

✅ Immediate output

Get immediate feedback on test failures while running them.

× // Tempest\Testing\Tests\TestFoo::a
  // /Dev/tempest-testing/tests/TestFoo.php:13
  // failed asserting that true is false

× // Tempest\Testing\Tests\TestFoo::b
  // /Dev/tempest-testing/tests/TestFoo.php:20
  // failed asserting that true is false

× // Tempest\Testing\Tests\TestFoo::e
  // /Dev/tempest-testing/tests/TestFoo.php:39
  // failed asserting that true is false

 2 succeeded   3 failed   0 skipped   0.12s

✅ Compose tests however you like

final class ApplicationTest
{
    use TestsEvents, TestsDatbase, TestsHttp;

    #[Test]
    public function test_before(): void
    {
        $this->events
            ->preventPropagation();
        
        $this->http
            ->post('/books', ['title' => 'Timeline Taxi'])
            ->assertRedirectTo('/books/timeline-taxi');
            
        $this->database
            ->assertContains('books', ['title' => 'Timeline Taxi']);
    }
}

✅ Tempest's no-config approach

Structure your tests however you like: in a separate dev namespaces or alongside your production code. Tempest's discovery will find them for you without any configuration on your part.

✅ Extensible event-driven architecture

Anything that happens during tests is easy to hook into with your own event listeners.

use Tempest\Container\Singleton;
use Tempest\Console\HasConsole;
use Tempest\EventBus\EventHandler;
use Tempest\Testing\Events\TestFailed;

#[Singleton]
final class TestEventListeners
{
    use HasConsole;

    #[EventHandler]
    public function onTestFailed(TestFailed $event): void
    {
        $this->error(sprintf('<style="fg-red">%s</style>', $event->name));
        $this->writeln(sprintf('  <style="fg-red dim">//</style> <style="fg-red underline">%s</style>', $event->location));
        $this->writeln(sprintf('  <style="fg-red dim">//</style> <style="fg-red">%s</style>', $event->reason));
        $this->writeln();
    }
}