NAME

Test::Async::Event – collection of standard events

SYNOPSIS

use Test::Async::Event;

test-bundle MyBundle {
    method foo(Str:D $message) is test-tool {
        self.send-test: Event::Ok, :$message
    }
}

DESCRIPTION

General information about Test::Async event management can be found in Test::Async::Manual.

Events are objects of classes derived from Event class. This module provides support for Test::Async core. In general, all event classes can be conventionally split into the following groups:

• informative – events signalling about some state changes. Like, for example, suite termination.

• reporting - events bearing a message to be reported to user.

• commands – those which tell the core to perform an action.

• tests – outcomes of individual test tools.

Class Event

The base event class.

Attributes

• $.origin – event originating object. Defaults to the current test suite object.

• Int:D $.id – event id, a sequential number.

• Instant:D $.time – the moment when event object was created.

Methods

• Profile – returns a Map suitable for passing to an event constructor. The method collects all changed public attributes of an object.

• gist, Str – stringify event object for reporting.

EVENT SUBCLASSES

• Test::Async::Event::BailOut

• Test::Async::Event::Command

• Test::Async::Event::Diag

• Test::Async::Event::DoneTesting

• Test::Async::Event::JobsAwaited

• Test::Async::Event::NotOk

• Test::Async::Event::Ok

• Test::Async::Event::Plan

• Test::Async::Event::Report

• Test::Async::Event::Skip

• Test::Async::Event::StageTransition

• Test::Async::Event::Telemetry

• Test::Async::Event::Terminate

• Test::Async::Event::Test

Command event classes Event::Cmd::*

A bundle of events used internally for commands. See Test::Async::Hub and possibly other modules. The set of command events is not standartized and subject for changes.

SEE ALSO

• Test::Async::Manual

• Test::Async::Aggregator

• Test::Async::Hub

• INDEX

COPYRIGHT

(c) 2020-2023, Vadim Belman <[email protected]>

LICENSE

Artistic License 2.0

See the LICENSE file in this distribution.