Reflection Assert

Fork of reflection assert from Unitils (http://www.unitils.org) compatible with JUnit 5 & other testing tools that support opentest4j.

Usage

reflection-assert

Assert that two objects are equal using reflection for field-by-field comparision:

assertReflectiveThat(actual).isEqualTo(expected);

Same, but ignoring order for collections:

assertLenientThat(actual).isEqualTo(expected);

Or assert that two objects are not equal providing custom message:

assertReflective().withMessage("message").that(actual).isNotEqualTo(unexpected);

A report for a failed assertion will look like:

Expected: User<name="John", title="CTO", address=Address<city="NY", street="2th">>
  Actual: User<name="John", title="Officer", address=Address<city="NY", street="1th">>

--- Found following differences ---
address.street: expected: "2th", actual: "1th"
title: expected: "CTO", actual: "Officer"

--- Difference detail tree ---
 expected: User<name="John", title="CTO", address=Address<city="NY", street="2th">>
   actual: User<name="John", title="Officer", address=Address<city="NY", street="1th">>

address expected: Address<city="NY", street="2th">
address   actual: Address<city="NY", street="1th">

address.street expected: "2th"
address.street   actual: "1th"

title expected: "CTO"
title   actual: "Officer"

reflection-assert-vintage

Provides reflection assertions in conformance with vintage Unitils API for smooth migration.

You may treat this module as a drop-in replacement for Unitils if the reflection assert was the only package used from Unitils in your system.

reflection-comparator

Additionally, you may want to compare two objects reflectively out of the test scope without getting dependency on JUnit and other test-related libs. Or maybe just get the difference report without any assertions involved.

You may achieve it by depending on this module only & directly using ReflectionComparator that could be obtained with opt-in leniency modes:

Difference diff = ReflectionComparatorFactory.createReflectionComparator().getDifference(a, b)

ReflectionComparatorFactory.createReflectionComparator(LENIENT_ORDER, LENIENT_DATES).isEqual(a, b)

Reports could be generated in the same format as for assertions:

new DefaultDifferenceReport().createReport(difference)

Dependency

Releases are available in Maven Central.

Just add the dependency:

Gradle

reflection-assert

testCompile 'com.github.hpple.reflection-assert:reflection-assert:0.3'

reflection-assert-vintage

testCompile 'com.github.hpple.reflection-assert:reflection-assert-vintage:0.3'

reflection-comparator

compile 'com.github.hpple.reflection-assert:reflection-comparator:0.3'

or

testCompile 'com.github.hpple.reflection-assert:reflection-comparator:0.3'

Maven

reflection-assert

<dependency>
    <groupId>com.github.hpple.reflection-assert</groupId>
    <artifactId>reflection-assert</artifactId>
    <version>0.3</version>
    <scope>test</scope>
</dependency>

reflection-assert-vintage

<dependency>
    <groupId>com.github.hpple.reflection-assert</groupId>
    <artifactId>reflection-assert-vintage</artifactId>
    <version>0.3</version>
    <scope>test</scope>
</dependency>

reflection-comparator

<dependency>
    <groupId>com.github.hpple.reflection-assert</groupId>
    <artifactId>reflection-comparator</artifactId>
    <version>0.3</version>
</dependency>

or

<dependency>
    <groupId>com.github.hpple.reflection-assert</groupId>
    <artifactId>reflection-comparator</artifactId>
    <version>0.3</version>
    <scope>test</scope>
</dependency>