eventually-matchers

Simple asynchronous hamcrest matchers

License	MIT
Categories	Ant Build Tools
GroupId	com.github.grantwest.eventually
ArtifactId	hamcrest-eventually-matchers
Last Version	0.0.3
Release Date	Sep 27, 2018
Type	jar
Description	eventually-matchers Simple asynchronous hamcrest matchers
Project URL	https://github.com/grantwest/eventually-matchers
Source Code Management	https://github.com/grantwest/eventually-matchers

Download hamcrest-eventually-matchers

Filename	Size
hamcrest-eventually-matchers-0.0.3.pom
hamcrest-eventually-matchers-0.0.3.jar	5 KB
hamcrest-eventually-matchers-0.0.3-sources.jar	2 KB
hamcrest-eventually-matchers-0.0.3-javadoc.jar	29 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.grantwest.eventually/hamcrest-eventually-matchers/ -->
<dependency>
    <groupId>com.github.grantwest.eventually</groupId>
    <artifactId>hamcrest-eventually-matchers</artifactId>
    <version>0.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.grantwest.eventually/hamcrest-eventually-matchers/
implementation 'com.github.grantwest.eventually:hamcrest-eventually-matchers:0.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.grantwest.eventually/hamcrest-eventually-matchers/
implementation ("com.github.grantwest.eventually:hamcrest-eventually-matchers:0.0.3")

Apache Buildr

'com.github.grantwest.eventually:hamcrest-eventually-matchers:jar:0.0.3'

Apache Ivy

<dependency org="com.github.grantwest.eventually" name="hamcrest-eventually-matchers" rev="0.0.3">
  <artifact name="hamcrest-eventually-matchers" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.grantwest.eventually', module='hamcrest-eventually-matchers', version='0.0.3')
)

Scala SBT

libraryDependencies += "com.github.grantwest.eventually" % "hamcrest-eventually-matchers" % "0.0.3"

Leiningen

[com.github.grantwest.eventually/hamcrest-eventually-matchers "0.0.3"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.hamcrest : java-hamcrest	jar	2.0.0.0

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Easy asynchronous asserts with JUnit & Hamcrest

Usage

These matchers are available via Maven Central. Add this to your pom.xml:

<dependency>
  <groupId>com.github.grantwest.eventually</groupId>
   <artifactId>hamcrest-eventually-matchers</artifactId>
   <version>0.0.3</version>
   <scope>test</scope>
</dependency>

Lets say another thread is supposed to add an element to a collection:

Collection<String> listOfNames; //Collection other thread is adding names to
assertThat(listOfNames, eventually(hasItem("Grant")));

To test a value we use a lambda:

boolean b = false; //Some other thread will set b to true
assertThat(() -> b, eventuallyEval(is(true)));

The eventually matchers have a default timeout of 5 seconds. The timeout can be overridden like this:

assertThat(() -> b, eventuallyEval(is(true), Duration.ofSeconds(30)));

To assert that someFunction() eventually returns true:

assertThat(() -> someFunction(), eventuallyEval(is(true)));

The matchers are known to work with:

• junit 4.12
• java-hamcrest 2.0.0.0

Versions

Version
0.0.3 Sep 27, 2018
0.0.1 Apr 24, 2016