Package limn.testing

Class HeadlessUi

java.lang.Object

limn.testing.HeadlessUi

All Implemented Interfaces:

AutoCloseable

public final class HeadlessUi
extends Object
implements AutoCloseable

A UiRuntime bound to the calling thread for the life of a test, so that the thread confinement every widget asserts holds on the JUnit thread, and the worker pool and queue behind Ui exist to be drained.

Open it in @BeforeEach, close it in @AfterEach. Twenty-five test classes wrote the four lines this constructor is and the two lines close() is, most of them beside a base class that already had them; this is the pair once, with the clock as the one thing a test chooses.

Constructor Summary

Constructors

Constructor	Description
HeadlessUi()	A runtime on the wall clock.
HeadlessUi(LongSupplier nanos)	A runtime on a clock the test controls.

Method Summary

Modifier and Type	Method	Description
void	close()	Uninstalls the runtime and stops the workers.
void	pumpUntil(BooleanSupplier done)	pumpUntil(BooleanSupplier, long) with a five-second limit.
void	pumpUntil(BooleanSupplier done, long timeoutNanos)	Spins the UI queue, the way a backend's loop does, until the condition holds.
UiRuntime	runtime()
ExecutorService	workers()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

HeadlessUi

public HeadlessUi()

A runtime on the wall clock.

HeadlessUi

public HeadlessUi(LongSupplier nanos)

A runtime on a clock the test controls.

Parameters:

nanos - what the runtime reads as now

Method Details

runtime

public UiRuntime runtime()

Returns:

the runtime installed as Ui's

workers

public ExecutorService workers()

Returns:

the worker pool behind Ui.async(java.util.function.Supplier<T>)

pumpUntil

public void pumpUntil(BooleanSupplier done,
 long timeoutNanos)

Spins the UI queue, the way a backend's loop does, until the condition holds.

Parameters:

done - what to wait for

timeoutNanos - how long to keep spinning

Throws:

AssertionError - if the condition does not hold in time

pumpUntil

public void pumpUntil(BooleanSupplier done)

pumpUntil(BooleanSupplier, long) with a five-second limit.

close

public void close()

Uninstalls the runtime and stops the workers.

Specified by:

close in interface AutoCloseable