🚫 Deprecated

Core

• Deprecate the following date/time related assertions in favor of isCloseTo:
  • isEqualToIgnoringHours
  • isEqualToIgnoringMinutes
  • isEqualToIgnoringSeconds
  • isEqualToIgnoringMillis
  • isEqualToIgnoringNanos
  • isInSameHourAs
  • isInSameMinuteAs
  • isInSameSecondAs
• Deprecate asList in favor of asInstanceOf #3138

✨ New Features

Core

• Add Descriptable#describedAs(Supplier<String>)

• Add isInThePast and isInTheFuture to LocalDate assertions #2933

• Add isInThePast and isInTheFuture to the missing Java 8 date/time types #2947

• Add isRecord and isNotRecord to Class assertions #2968

• Add hasNullValue and doesNotHaveNullValue to AtomicReferenceAssert #2969

• Add asBoolean|Byte|Short|Int|Long|Float|Double to String assertions #2580

• Add hasRecordComponents to Class assertions #2995

• Add getters for field path in ComparisonDifference #3007

• Allow to compare enum and string fields in the recursive comparison #2616

• Provide value when assertThatThrownBy / thenThrownBy fail #3043

• Add isSealed and isNotSealed to Class assertions #3080

• Add assertThatCharSequence to disambiguate Groovy's GString #3132

• Change the way the properties are collected using the Class.getMethods() API instead of iterating the class hierarchy using Class.declaredMethods() #3135

• Add default constructor for RecursiveComparator #3206

• Add isPrimitive and isNotPrimitive to Class assertions #2722

• Add anyOf(ThrowingConsumer...) and allOf(ThrowingConsumer...) #3219

  Details

  What was written as:

  assertThat(elements)
    .extracting(Element::getProperty)
    .allSatisfy(p -> assertThat(p).satisfiesAnyOf(
        p1 -> assertThat(p1).isNull(),
        p1 -> assertThat(p1).isNotNull().extracting(Property::getId).isEqualTo(expected)
    ));

  can now be shortened to:

  assertThat(elements)
    .extracting(Element::getProperty)
    .allSatisfy(anyOf( // statically imported from Assertions
        p1 -> assertThat(p1).isNull(),
        p1 -> assertThat(p1).isNotNull().extracting(Property::getId).isEqualTo(expected)
    ));

• Show the array/iterable under test in the assertion error message when it is not empty but should have been #3230

🐛 Bug Fixes

Core

• Compare Java types from javax and com.sun by their equals method in recursive comparison #2928
• The recursive comparison comparingOnlyFields did not treat array/iterable elements as root objects #2994
• Fixes a bug when failing assertions on DirectoryStream types #3036
• Fix handling of null containers in the recursive assertion #3045
• Handle null values in map entry sets when formatting #3087
• Fix NPE when expected and actual field values are null #3034
• Fix NPE on anyMatch when actual contains null and Objects::isNull is used as predicate #3151
• Fix misleading subsequence failure messages in string assertions #3166
• Do not ignore nested fields of types specified in comparingOnlyFieldsOfTypes #3207
• containsExactly does not work properly with maps not using equals to compare keys #2165
• Escape percentage in shouldContainExactly error message #3288
• Fix recursive comparison of ignored types in unordered collection #3287

⚡ Improvements

• Add Spotless #3115

Core

• Use Bnd feature to write resolved bndrun files to output folder #2902

• Add Throwable stack trace to ShouldHaveClause #2872

• Avoid copy of any Collection instance in Iterables::assertContains

• Add Throwable stack trace to ShouldHaveRootCauseInstance and ShouldHaveRootCauseExactlyInstance #2910

• Add missing description to nested condition #2755

• Make nestable condition factory accept conditions on super types #2905

• Add varargs overload to Assert::hasString and Assert::doesNotHaveString #2945

• Improve recursive comparison performance by caching field and field names result #2979

• Document performance cost of ignoring collection order

• Track visited values and their comparison differences so that they can be reused #2954

• Use hash code for compareUnorderedIterables to improve performance in some common cases #3020

• Improve recursive comparison error message regarding equals methods used for JDK types #2678

• Format large arrays as strings #3065

• Remove null check as isArray already performs it

• Fix PrimitiveArralList/TransformlingList test file names #3124

• Add exception for usages of isEqualTo and isNotEqualTo on assertions #2921

  Details

  Before this change, the following code:

  AbstractAssert<?, ?> assertion = assertThat(something);
  assertThat(assertion).isEqualTo(assertion);

  would throw an exception with a message about equals being unsupported, suggesting to use isEqualTo instead. The message is somewhat confusing to the reader, since isEqualTo is indeed used, and is because isEqualTo internally relies on the equals of actual, which is an AbstractAssert instance and throws the exception above.

  isEqualTo and isNotEqualTo now check if actual is an assertion instance and raise an UnsupportedOperationException if so, with a message suggesting to use isSameAs and isNotSameAs instead.

  This is, for example, useful for testing custom assertion types for extension libraries, where the use of satisfies instead of isEqualTo may be desirable.

• Add check for missing fields in recursive comparison where specific fields are requested for comparison

• Improve efficiency of iterable string conversion #3123

• Add more tests for usingRecursiveComparison #2790

• Checks that compared fields exist before running the recursive comparison #3129

• Remove maven-surefire-plugin duplicate version #3180

• Remove Maven default goal #3182

• Add dependency graph workflow

• Normalize non-breaking spaces like regular white spaces #3120

• AbstractOffsetDateTimeAssert::isBetween parameter names should use inclusive, not exclusive #3217

• Invoke isNotNull in returns and doesNotReturn #3224

• Cache node names in ComparingFields, ComparingProperties #3242

• Cache node names in ComparingNormalizedFields

• Use simpler syntax in DefaultRecursiveComparisonIntrospectionStrategy.getChildrenNodeNamesOf

• Update to Contributor Covenant Code of Conduct v2.1

• Correct contains assertion Javadoc to reflect method behavior in case actual is not empty and the group of values to look for is #3256

• Fix Javadoc typos #3265

• Improving null-safety of isEqualToNormalizingNewlines #2776

• Speed up for BinaryDiff performance #3193

• Upgrade workflows to Java 21 #3191

• Apply flatten-maven-plugin to assertj-core and assertj-guava #3311

🔨 Dependency Upgrades

Core

• Upgrade to Byte Buddy 1.14.11 #330
• Upgrade to JUnit BOM 5.10.1 #3254
• Upgrade to OpenTest4J 1.3.0 #3122

Guava

• Upgrade to Guava 32.1.3-jre #3218

❤️ Contributors

Thanks to all the contributors who worked on this release:

@bjhargrave @vlsi @Ds2994 @StefanBratanov @alex859 @ascopes @ljrmorgan @ghkim3221 @hezean @matthew-leng @etellman @hjir @amodolo @armandino @aindriu-aiven @Bananeweizen @JohnBryte @ManuelG28 @maximedezette @radistao @ykardziyaka @wouterpolet @sarajuhosova @pbacz @Gabriel-Darbord @Nacho321 @marcela-cardona-s @matthiaskraaz @quaff @grigala @martinfrancois @georgebax