Plugins for Testo to test code built on thesis packages.
composer require --dev thesis/testo-pluginRequires 64-bit PHP 8.5+.
VirtualTimePlugin and the #[VirtualTime] attribute run a test in its own Thesis\Async\VirtualTime\run()
of thesis/async: the clock jumps to the next timer whenever nothing can run,
so delay(hours(1)) is over at once and durations can be asserted exactly. How the virtual clock behaves is described
in the README of thesis/async.
Every test of a suite, with the plugin in testo.php:
use Testo\Application\Config\ApplicationConfig;
use Testo\Application\Config\SuiteConfig;
use Thesis\TestoPlugin\VirtualTimePlugin;
return new ApplicationConfig(
suites: [
new SuiteConfig(name: 'unit', location: [__DIR__ . '/tests'], plugins: [new VirtualTimePlugin()]),
],
);Or only some, with the attribute on a test class or a test:
use Testo\Assert;
use Testo\Test;
use Thesis\Async\Instant;
use Thesis\TestoPlugin\VirtualTime;
use function Thesis\Async\delay;
use function Thesis\Time\hours;
#[Test]
final class HeartbeatTest
{
#[VirtualTime]
public function waitsAnHour(): void
{
$start = Instant::now();
delay(hours(1));
Assert::equals(Instant::now()->since($start), hours(1));
}
}The lifecycle hooks of a test (#[BeforeTest], #[AfterTest]) run on its clock, and every data set gets a clock
of its own. A test that has the attribute in a suite with the plugin is not wrapped twice.
PHP only prints a warning, a notice or a deprecation, and the test passes. PhpErrorsPlugin throws one
as ErrorException where it happens, in the test and in the tasks it starts alike, so the test fails
and the trace points at the cause. An error suppressed by @ is left alone, and a handler that the test sets itself
sees the errors first.
Every suite, with the plugin in testo.php:
use Testo\Application\Config\ApplicationConfig;
use Testo\Application\Config\SuiteConfig;
use Thesis\TestoPlugin\PhpErrorsPlugin;
return new ApplicationConfig(
suites: [
new SuiteConfig(name: 'unit', location: [__DIR__ . '/tests']),
],
plugins: [new PhpErrorsPlugin()],
);