Popularity
7.1
Growing
Activity
6.3
Declining
2,255
69
177

Description

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:

Code Quality Rank: L5
Programming language: Java
Tags: Testing    
Latest version: v4.0.2

Awaitility alternatives and similar libraries

Based on the "Testing" category

Do you think we are missing an alternative of Awaitility or a related project?

Add another 'Testing' Library

README

[Awaitility](resources/Awaitility_logo_red_small.png)

Build Status Maven Central Javadoc

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() {
    // Publish an asynchronous message to a broker (e.g. RabbitMQ):
    messageBroker.publishMessage(updateCustomerStatusMessage);
    // Awaitility lets you wait until the asynchronous operation completes:
    await().atMost(5, SECONDS).until(customerStatusIsUpdated());
    ...
}

News

  • 2020-05-19: Awaitility 4.0.3 is released. This release includes updates to ConditionEvaluationLogger as well as several depdency updates. If you're using the Groovy DSL beaware that Groovy has been upgraded from 2.x to 3.x. See changelog for details.
  • 2020-01-03: Awaitility 4.0.2 is released. This release includes support for asserting that a condition is maintained for specific duration, improvments to ConditionEvaluationListener as well as several bug fixes and other improvements. See changelog for details.
  • 2019-09-06: Awaitility 4.0.1 is released and it fixes a regression issue in which the condition evaluation duration could be evaluated to a negative number of nanoseconds on Windows. It also drops the dependency to objenesis since it's no longer used after moving to Java 8. See changelog for details.

Older news

Documentation