Skip to content

AssertJ is a library of assertions similar to fest-assert but providing a richer set of assertions.

License

Notifications You must be signed in to change notification settings

apierzch/assertj-core

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AssertJ - Fluent assertions for java

AssertJ provides a rich and intuitive set of strongly-typed assertions to use for unit testing (either with JUnit or TestNG).

Documentation of all AssertJ projects is maintained on assertj.org, AssertJ Core documentation is here.

You can ask questions and make suggestions on AssertJ google group.

AssertJ's ambition is to provide a rich and intuitive set of strongly-typed assertions to use for unit testing.
The idea is that, when writing unit tests, we should have at our disposal assertions specific to the type of the objects we are checking. If you're checking the value of a String, you use String-specific assertions. Checking the value of a Map? Use the Map-specific assertions, which make it easy to check on the contents of the map.

AssertJ is composed of several modules:

Assertion missing? Please create an issue!

AssertJ's assertions are super easy to write: just type assertThat followed by the actual value in parentheses and then a dot, and any Java IDE will show you all the assertions available for the type of the object to verify. No more confusion about the order of the "expected" and "actual" values. Our assertions are very readable as well: they read very close to plain English, making it easier for non-technical people to read test code. A lot of effort have been done to provide intuitive error messages showing as clearly as possible what the problem is.

Note that AssertJ requires at least Java 6.

AssertJ core javadoc is published here.

To read details on the latest releases, please go to AssertJ Core latest news.

It is easy to start using AssertJ, follow the One minute starting guide.

Having assertions for common types like List is great, but you might want some that are specific to your own types. This is possible with AssertJ because it is easily extensible so it's simple to write assertions for your custom types.

Moreover, to ease your work, we provide assertions generator that can take a set of custom types and create specific assertions. The tools provided are:

To help you replace JUnit assertions by AssertJ ones, you can use a script or do regexp search and replace manually as indicated here.

Check our migration guide, it covers migrating from Fest 1.4 and migrating from Fest 2.x.

You are encouraged to contribute any missing, useful assertions. To do so, please read the contributors section.

About

AssertJ is a library of assertions similar to fest-assert but providing a richer set of assertions.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.7%
  • Shell 0.3%