Testing asynchronous systems is hard. Not only does it require handling threads, timeouts and concurrency issues, but the intent of the test code can be obscured by all these details. Awaitility is a DSL that allows you to express expectations of an asynchronous system in a concise and easy to read manner. For example:

@Test
public void updatesCustomerStatus() throws Exception {
    // Publish an asynchronous event:
    publishEvent(updateCustomerStatusEvent);
    // Awaitility lets you wait until the asynchronous operation completes:
    await().atMost(5, SECONDS).until(costumerStatusIsUpdated());
    ...
}

News

• 2012-02-14: Awaitility was presented at JFokus.
• 2012-02-13: Awaitility 1.3.4 is released. See change log for details.
• 2011-11-16: Awaitility was presented at Devoxx 2011 in Antwerp.
• 2011-09-22: Awaitility 1.3.3 is released with better support for atomic data structures.

Older news

Documentation

• Getting started
• User Guide
• Awaitility Javadoc

Founded by:

Other open source projects: