com.github.writethemfirst.approvals.reporters

Class ThrowsReporter

java.lang.Object

com.github.writethemfirst.approvals.reporters.ThrowsReporter

All Implemented Interfaces:

Reporter

public class ThrowsReporter
extends java.lang.Object
implements Reporter

The most basic Reporter, it simply throws an AssertionError in case of mismatch between approved and received. It is always available.

Constructor Summary

Constructors

Constructor and Description
ThrowsReporter()

Method Summary

Modifier and Type	Method and Description
boolean	isAvailable() A Reporter may not be relevant in all contexts, and they should provide some automated checks validating that they’re actually able to perform what they’re supposed to do in the current execution context (like libraries available in the classpath or Diff / Merge programs available on the computer).
void	mismatch(java.nio.file.Path approvedPath, java.nio.file.Path receivedPath) A Reporter is called whenever a difference is found while comparing the output of a Program Under Tests and the existing approved files linked to the tests.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ThrowsReporter

public ThrowsReporter()

Method Detail

mismatch

public void mismatch(java.nio.file.Path approvedPath,
                     java.nio.file.Path receivedPath)

Description copied from interface: Reporter

A Reporter is called whenever a difference is found while comparing the output of a Program Under Tests and the existing approved files linked to the tests. That method is the one which will be called by the framework, specifying the approved and received files which present differences.

It is then used to implement the behavior to execute for dealing with that mismatch between both files.

Specified by:

mismatch in interface Reporter

Parameters:

approvedPath - The Path to the approved file (which contains the data reviewed and approved by the developer)

receivedPath - The Path to the temporary received file (which contains the data generated by the Program Under Tests)

Throws:

java.lang.AssertionError - if the 2 contents do not match

isAvailable

public boolean isAvailable()

Description copied from interface: Reporter

A Reporter may not be relevant in all contexts, and they should provide some automated checks validating that they’re actually able to perform what they’re supposed to do in the current execution context (like libraries available in the classpath or Diff / Merge programs available on the computer).

This method allows to state if a Reporter should be executed in case any differences are found during the comparison of approved and received files. If it returns false, the Reporter won’t be used.

Specified by:

isAvailable in interface Reporter

Returns:

true if the Reporter can be used in the current execution context.