doc / ch.tutteli.atrium.assertions.builders / Descriptive / DescriptionOption

DescriptionOption

interface DescriptionOption<R>

Option step which allows to specify the description of a descriptive like assertion (such as DescriptiveAssertion).

Properties

test

abstract val test: () -> Boolean

The previously defined test which is used to determine Assertion.holds.

Functions

withDescriptionAndRepresentation

open fun withDescriptionAndRepresentation(description: String, representation: Any?): R

Wraps the given description into an Untranslatable and uses it as DescriptiveAssertion.description next to representation which is used as DescriptiveAssertion.representation unless representation is null in which case a representation for null is used (e.g. RawString.NULL).

abstract fun withDescriptionAndRepresentation(description: Translatable, representation: Any?): R

Uses the given description as DescriptiveAssertion.description and representation as DescriptiveAssertion.representation unless representation is null in which case a representation for null is used (e.g. RawString.NULL).

Companion Object Functions

create

fun <R> create(test: () -> Boolean, factory: (() -> Boolean, Translatable, Any) -> R): Descriptive.DescriptionOption<R>

Factory method to create the DescriptionOption step based on the given test and another factory method which creates the next step in the building process of a descriptive assertion.

Extension Functions

withFailureHint

fun Descriptive.DescriptionOption<Descriptive.FinalStep>.withFailureHint(failureHintFactory: () -> Assertion): DescriptiveAssertionWithFailureHint.ShowOption

Option to create a DescriptiveAssertion like assertion with an additional hint which might be shown if the Descriptive.DescriptionOption.test fails.

withFailureHintBasedOnDefinedSubject

fun <T> Descriptive.DescriptionOption<Descriptive.FinalStep>.withFailureHintBasedOnDefinedSubject(subjectProvider: SubjectProvider<T>, failureHintFactory: (T) -> Assertion): Descriptive.DescriptionOption<DescriptiveAssertionWithFailureHint.FinalStep>

Option to create a DescriptiveAssertion like assertion with an additional hint which is based on the subject of the assertion and which is only shown the subject is defined.

withFailureHintBasedOnSubject

fun <T> Descriptive.DescriptionOption<Descriptive.FinalStep>.withFailureHintBasedOnSubject(subjectProvider: SubjectProvider<T>, failureHintSubStep: DescriptiveAssertionWithFailureHint.FailureHintSubjectDefinedOption<T>.() -> Pair<() -> Assertion, (T) -> Assertion>): DescriptiveAssertionWithFailureHint.ShowOption

Option to create a DescriptiveAssertion like assertion with an additional hint (which is based on the subject of the assertion) which might be shown if the Descriptive.DescriptionOption.test fails.