AssertJ @ hack-commit-push 2021

[scordio]

hack-commit-push 2021

On May 29th there is hack-commit-push, one day to contribute to Open Source.

What is AssertJ

AssertJ is a Java library for test assertions, which:

• Provides rich assertions for 50+ Java types
• Improves test code readability with fluent API
• Is easy to use within your favorite IDE
• Reports helpful error messages when assertions fail
• Has javadoc with code examples

Basic Assertions

assertThat("Gandalf")                      
  .as("Check a famous magician name")
  .isNotNull()                       
  .isInstanceOf(String.class)        
  .isNotEqualTo("Saruman")         
  .isEqualTo("Gandalf");

• Start with Assertions.assertThat(target)
• Discover assertions with code completion
• Chain assertions

Modules

AssertJ is composed of several modules:

• A core module to provide assertions for JDK types (String, Iterable, Stream, Path, File, Map, ...)
• A Guava module to provide assertions for Guava types (Multimap, Optional, ...)
• A Joda Time module to provide assertions for Joda Time types (DateTime, LocalDateTime, ...)
• A Neo4J module to provide assertions for Neo4J types (Path, Node, Relationship, ...)
• A DB module to provide assertions for relational database types (Table, Row, Column, ...)
• A Swing module provides a simple and intuitive API for functional testing of Swing user interfaces

More details can be found in the official documentation.

Development Environment

Prerequisites

• Git
• JDK 11 or newer

Minimal Setup

git clone https://github.com/assertj/assertj-core.git
cd assertj-core
./mvnw clean verify

Any Java capable IDE can be used to develop AssertJ (e.g., IntelliJ IDEA, Eclipse, Visual Studio Code, etc.).

More about coding style and patterns on the contributing section.

Topics to Work On

• Issues added to the hack-commit-push GitHub project
• Any other issue of assertj-core which has not been started yet (to be discussed with the maintainers if the issue would fit in the event)
• New proposals about missing useful assertions!

[scordio]

The event is over, so locking this discussion.