fi.jumi.api.drivers

Interface SuiteNotifier

public interface SuiteNotifier

Method Summary

Methods

Modifier and Type	Method and Description
void	fireInternalError(String message, Throwable cause) Notifies about an internal error in the testing framework, i.e.
void	fireTestFound(TestId testId, String name) Notifies about the existence of a test.
TestNotifier	fireTestStarted(TestId testId) Notifies about the beginning of a test execution.

Method Detail

fireTestFound

void fireTestFound(TestId testId,
                 String name)

Notifies about the existence of a test.

Must be called before starting the test.^[1] Must be called with parent testId before any of its children.^[2] Idempotent,^[3] but the name must always be the same if called multiple times.^[4]

References:

[1]: onTestFound_must_be_called_before_onTestStarted,
[2]: parents_must_be_found_before_their_children,
[3]: removes_duplicate_onTestFound_events,
[4]: tests_must_be_found_always_with_the_same_name

fireTestStarted

TestNotifier fireTestStarted(TestId testId)

Notifies about the beginning of a test execution.

May be called multiple times, before a test is finished, to produce nested tests.^[1] The only limitation is that a nested test must be finished before the surrounding tests.^[2]

Everything printed to System.out^[3] and System.err^[4] after the call to this method^[5] will be recorded from the current thread^[6] and threads which are started by it^[7] (possibly together with timestamps and name of the thread which printed it).

Returns:

a notifier for the events of the test execution that was just started.

See Also:

TestNotifier.fireTestFinished()

References:

[1]: notifies_about_the_beginning_and_end_of_a_run,
[2]: fireTestFinished_must_be_called_on_the_current_test,
[3]: captures_stdout & replaces_stdout_with_the_captured_stream,
[4]: captures_stderr & replaces_stderr_with_the_captured_stream,
[5]: captures_what_is_printed_during_a_run,
[6]: concurrent_captures_are_isolated_from_each_other,
[7]: captures_what_is_printed_in_spawned_threads

fireInternalError

void fireInternalError(String message,
                     Throwable cause)

Notifies about an internal error in the testing framework, i.e. not a test failure.