Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

Welcome to the FEST Fluent Assertions Module

FEST-Assert is a Java library that provides a fluent interface for writing assertions. Its main goal is to improve test code readability and make maintenance of tests easier.

FEST-Assert requires Java SE 5.0 or later and can be used with either JUnit or TestNG.

Currently, this module provides assertions for the following data types:

  • Object
  • String
  • Collection
  • Map
  • Primitives (boolean, int, char, etc.)
  • Arrays of Object
  • Arrays of primitives
  • BufferedImage
  • Throwable
  • File
  • BigDecimal

It can be downloaded here. For Maven 2 users, details about the project's repository can be found at here.

We have written a migration guide to easily replace JUnit assertions with Fest assertions. Note that FEST & JUnit assertions can coexist together, you don't have to migrate all in one time.

Examples

Some simple example to start.

Code Block
java
java
import static org.fest.assertions.Assertions.assertThat;

int removed = employees.removeFired();
assertThat(removed).isZero();

List<Employee> newEmployees = employees.hired(TODAY);
assertThat(newEmployees).hasSize(6)
                        .contains(frodo, sam);

String[] newHires = employees.newHiresNames();
assertThat(newHires).containsOnly("Gandalf", "Arwen", "Gimli");

assertThat(yoda).isInstanceOf(Jedi.class)
                .isEqualTo(foundJedi)
                .isNotEqualTo(foundSith);
Section
Column
width50%

Custom Error Messages
Specifying custom error messages.

Column
width50%

Extending
Extending FEST-Assert with custom conditions and assertions.

Section
Column
width50%

JUnit-Specific Features
FEST-Assert supports JUnit-specific features.

Column
width50%

Comparing to Hamcrest
Comparing FEST-Assert and Hamcrest.

Section
Column
width50%

More Examples
Examples that how more complex usages of our assertions.

Column
width50%

Migration from JUnit
An easy guide on how to migrate from JUnit's own assertions to ours.