This repository contains AssertJs website.
To contribute, please read how to edit AssertJs site.
Please use https://github.com/joel-costigliola/assertj-core/issues to create issues for AssertJ Core itself.
AssertJ alternatives and similar libraries
Based on the "Testing" category.
Alternatively, view assertj-core alternatives based on common mentions on social networks and blogs.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.
Do you think we are missing an alternative of AssertJ or a related project?
AssertJ - Fluent assertions for java
AssertJ provides a rich and intuitive set of strongly-typed assertions to use for unit testing (with JUnit, TestNG or any other test framework).
- AssertJ's goals
- Quick start
- Latest News
- AssertJ web site contains the AssertJ Core documentation.
- Assertions for custom types (still in the old site but will soon be available in the new site)
- Replacing JUnit assertions with AssertJ Assertions
You can ask questions in stackoverflow (assertj tag) and make suggestions by simply creating an issue.
AssertJ's ambition is to provide a rich and intuitive set of strongly-typed assertions for unit testing.
The idea is that disposal assertions should be specific to the type of the objects we are checking when writing unit tests. If you're checking the value of a
String, you use String-specific assertions. Checking the value of
Map? Use Map-specific assertions to easily check the contents of the map.
AssertJ is composed of several modules:
- A core module (this one) to provide assertions for JDK types (
Map...) - see AssertJ Core documentation and javadoc.
- A Guava module to provide assertions for Guava types (
Optional...) - see AssertJ Guava documentation and javadoc.
- A Joda Time module to provide assertions for Joda Time types (
LocalDateTime) - see AssertJ Joda Time documentation and javadoc.
- A Neo4J module to provide assertions for Neo4J types (
Relationship...) - see AssertJ Neo4J documentation and javadoc.
- A DB module to provide assertions for relational database types (
Column...) - see AssertJ DB documentation and javadoc.
- A Swing module provides a simple and intuitive API for functional testing of Swing user interfaces - see AssertJ Swing documentation and javadoc.
Assertion missing? Please create an issue!
AssertJ's assertions are super easy to use: just type
assertThat followed by the actual value in parentheses and a dot,
then any Java IDE will show you all assertions available for the type of the object. No more confusion about the
order of "expected" and "actual" value.
AssertJ's assertions are very close to plain English.
A lot of effort has been spent to provide intuitive failure messages showing clearly why the assertion failed.
Note that AssertJ 3.x requires at least Java 8 and AssertJ 2.x requires at least Java 7.
It is easy to start using AssertJ, just follow the one minute starting guide.
To read details on the latest releases, please go to AssertJ Core latest news.
Assertions for custom types
Having assertions for common types like
List is great, but you might want some assertions specific to your own types. It is simple to write assertions for your custom types with AssertJ because it is easily extensible.
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:
Replacing JUnit assertions with AssertJ Assertions
Want to contribute?
You are encouraged to contribute any missing, useful assertions. To do so, please read the contributing section.