Simple testing framework. Provides fluent syntax for various assertions.

This project is distributed via JitPack. Register a JitPack repository at your pom.xml:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

And add the following dependency:

<dependency>
    <groupId>com.github.jolice</groupId>
    <artifactId>Citron</artifactId>
    <version>v1.0</version>
    <scope>test</scope>
</dependency>

All assertions begin with assertThat() followed by an application of the matchers.

int result = 2 + 2;
assertThat(result)
       .isNotNull()
       .and()
       .is(4)
       .and()
       .isIn(3, 4, 5);

Assertions are chained and separated by and() expression. All assertions are evaluated in the order they are specified in. It means that, for the specified example, result will be first checked for nulity, then whether it's equal to 4 and then whether it's in the [3, 4, 5] collection.

List of currently supported assertions:

Method assertions allow for asserting whether an execution of some method (or multiple methods) was completed without producing an exception.

For example, given the method:

public void fail() {
    throw new UnsupportedOperationException();
}

The following assertion will pass:

assertThat(this::fail)
        .doesThrow(UnsupportedOperationException.class);

To assert that method completes without throwing a runtime exception:

String result = "abcde";
assertThat(() -> result.substring(1))
         .completesNormally();

There are some additional assertions for string provided, such as contains or whether string is equal to another one ignoring the case.

assertThat("abcde")
        .isNotNull()
        .and()
        .ignoringCase().is("AbCdE")
        .and()
        .contains("bcd");

Full list of assertion methods for the strings: