Package org.approvej

Class ApprovalBuilder<T>

java.lang.Object

org.approvej.ApprovalBuilder<T>

Type Parameters:

T - the type of the value to approve

@NullMarked
public class ApprovalBuilder<T>
extends Object

A builder to configure an approval for a given value.

E.g. approve(result).byFile(); will approve the result with the content of a file next to the test.

Printing

Before approval, the value needs to be printed (turned into a String). You can use the method printWith(Printer) to customize that. By default, the value's toString method will be called.

E.g. approve(result).printWith(objectPrinter()).byFile(); prints the given object using the given ObjectPrinter.

Scrubbing

The value can also be scrubbed of dynamic data (like timestamps or ID's).

E.g. approve(result).scrubbedOf(uuids()).byFile(); will replace all UUID's in the result before approval.

Approving

The builder is concluded by specifying an approver to approve the value by ( byFile() and byValue(String)).

E.g. approve(result).byFile(); approves the result with the content of a file next to the test, while approve(result).byValue(approved); approves the result with the given approved value.

Field Summary

Fields

Modifier and Type	Field	Description
static final Printer<Object>	DEFAULT_PRINTER	The default Printer used to print the value.

Method Summary

Modifier and Type	Method	Description
static <T> ApprovalBuilder<T>	approve(T originalValue)	Creates a new builder for the given value.
void	by(Consumer<String> approver)	Approves the receivedValue by the given approver.
void	byFile()	Approves the receivedValue by a FileApprover, a NextToTestPathProvider, and the Printer.filenameExtension().
void	byFile(String approvedPath)	Approves the receivedValue by a FileApprover with an ApprovedPathProvider and the given path to the approved file.
void	byFile(Path approvedPath)	Approves the receivedValue by a FileApprover with an ApprovedPathProvider and the given Path to the approved file.
void	byFile(PathProvider pathProvider)	Approves the receivedValue by a FileApprover with the given PathProvider.
void	byValue(String previouslyApproved)	Approves the value by an InplaceApprover with the given previouslyApproved value.
ApprovalBuilder<String>	printWith(Function<T,String> printer)	Uses the given Function to convert the receivedValue to a String.
ApprovalBuilder<String>	printWith(Printer<T> printer)	Uses the given Printer to convert the receivedValue to a String.
ApprovalBuilder<T>	scrubbedOf(UnaryOperator<T> scrubber)	Applies the given scrubber to the current receivedValue.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_PRINTER

public static final Printer<Object> DEFAULT_PRINTER

The default Printer used to print the value.

Method Details

approve

public static <T> ApprovalBuilder<T> approve(T originalValue)

Creates a new builder for the given value.

Type Parameters:

T - the type of the value to approve

Parameters:

originalValue - the value to approve

Returns:

a new ApprovalBuilder for the given value

printWith

public ApprovalBuilder<String> printWith(Function<T,String> printer)

Uses the given Function to convert the receivedValue to a String.

Parameters:

printer - the Function used to convert the receivedValue to a String

Returns:

this

printWith

public ApprovalBuilder<String> printWith(Printer<T> printer)

Uses the given Printer to convert the receivedValue to a String.

Parameters:

printer - the printer used to convert the value to a String

Returns:

this

scrubbedOf

public ApprovalBuilder<T> scrubbedOf(UnaryOperator<T> scrubber)

Applies the given scrubber to the current receivedValue.

Parameters:

scrubber - the UnaryOperator or Scrubber

Returns:

this

by

public void by(Consumer<String> approver)

Approves the receivedValue by the given approver.

If necessary the receivedValue is printed using the DEFAULT_PRINTER.

Parameters:

approver - a Consumer or an Approver implementation

Throws:

ApprovalError - if the approval fails

byValue

public void byValue(String previouslyApproved)

Approves the value by an InplaceApprover with the given previouslyApproved value.

Parameters:

previouslyApproved - the approved value

byFile

public void byFile()

Approves the receivedValue by a FileApprover, a NextToTestPathProvider, and the Printer.filenameExtension().

Throws:

ApprovalError - if the approval fails

byFile

public void byFile(PathProvider pathProvider)

Approves the receivedValue by a FileApprover with the given PathProvider.

Parameters:

pathProvider - the provider for the paths of the approved and received files

Throws:

ApprovalError - if the approval fails

byFile

public void byFile(Path approvedPath)

Approves the receivedValue by a FileApprover with an ApprovedPathProvider and the given Path to the approved file.

Parameters:

approvedPath - the Path to the approved file

Throws:

ApprovalError - if the approval fails

byFile

public void byFile(String approvedPath)

Approves the receivedValue by a FileApprover with an ApprovedPathProvider and the given path to the approved file.

Parameters:

approvedPath - the path to the approved file

Throws:

ApprovalError - if the approval fails