fun <E : Any, T : Iterable<E?>> IterableContains.CheckerOption<E?, T, InAnyOrderSearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where an entry shall be searched which either
holds all assertions assertionCreatorOrNull creates or needs to be null in case
assertionCreatorOrNull is defined as null -- likewise an entry (can be the same) is searched for each
of the otherAssertionCreatorsOrNulls.
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E : Any, T : Iterable<E?>> IterableContains.Builder<E?, T, InAnyOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where an entry needs to be contained in the
Iterable which holds all assertions assertionCreatorOrNull creates or needs to be null in case
assertionCreatorOrNull is defined as null -- likewise an entry for each
otherAssertionCreatorsOrNulls needs to be contained in the Iterable where it does not matter in which order the
entries appear but only as many entries should be returned by the Iterable as assertion creators are defined.
Notice, that a first-wins strategy applies which means your assertion creator lambdas -- which kind of serve as
identification lambdas -- should be ordered in such a way that the most specific identification lambda appears
first, not that a less specific lambda wins. For instance, given a setOf(1, 2) you should not search for
entries({ isGreaterThan(0) }, { toBe(1) }) but for
entries({ toBe(1) }, { isGreaterThan(0) }) otherwise
isGreaterThan(0) matches 1 before toBe(1) would match it. As a consequence toBe(1) could only match the
entry which is left -- in this case 2 -- and of course this would fail.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E : Any, T : Iterable<E?>> IterableContains.Builder<E?, T, InOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where the Iterable needs to contain only an
entry which holds all assertions assertionCreatorOrNull creates or is null in case assertionCreatorOrNull
is defined as null and likewise a further entry for each
otherAssertionCreatorsOrNulls (if given) whereas the entries have to appear in the specified order.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E : Any, T> IterableLikeContains.CheckerStep<out E?, T, InAnyOrderSearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where an entry shall be searched which either
holds all assertions assertionCreatorOrNull creates or needs to be null in case
assertionCreatorOrNull is defined as null -- likewise an entry (can be the same) is searched for each
of the otherAssertionCreatorsOrNulls.
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.
fun <E : Any, T> IterableLikeContains.EntryPointStep<out E?, T, InAnyOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where an entry needs to be contained in the
IterableLike which holds all assertions assertionCreatorOrNull creates or needs to be null in case
assertionCreatorOrNull is defined as null -- likewise an entry for each
otherAssertionCreatorsOrNulls needs to be contained in the IterableLike where it does not matter
in which order the entries appear but only as many entries should be returned by the IterableLike
as assertion creators are defined.
Notice, that a first-wins strategy applies which means your assertion creator lambdas -- which kind of serve as
identification lambdas -- should be ordered in such a way that the most specific identification lambda appears
first, not that a less specific lambda wins. For instance, given a setOf(1, 2) you should not search for
entries({ isGreaterThan(0) }, { toBe(1) }) but for
entries({ toBe(1) }, { isGreaterThan(0) }) otherwise
isGreaterThan(0) matches 1 before toBe(1) would match it. As a consequence toBe(1) could only match the
entry which is left -- in this case 2 -- and of course this would fail.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.
fun <E : Any, T> IterableLikeContains.EntryPointStep<out E?, T, InOrderOnlySearchBehaviour>.entries(assertionCreatorOrNull: (Expect<E>.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Expect<E>.() -> Unit)?): Expect<T>
Finishes the specification of the sophisticated contains assertion where the IterableLike
needs to contain only an entry which holds all assertions assertionCreatorOrNull creates
or is null in case assertionCreatorOrNull is defined as null and likewise a further entry for each
otherAssertionCreatorsOrNulls (if given) whereas the entries have to appear in the specified order.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
assertionCreatorOrNull - The identification lambda which creates the assertions which the entry we are looking
for has to hold; or in other words, the function which defines whether an entry is the one we are looking for
or not. In case it is defined as null, then an entry is identified if it is null as well.
otherAssertionCreatorsOrNulls - Additional identification lambdas which each identify (separately) an entry
which we are looking for (see assertionCreatorOrNull for more information).
AssertionError - Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.