trait
AppendedClues
extends AnyRef
Type Members
-
class
Clueful
[T]
extends AnyRef
Value Members
-
def
!=
(arg0: AnyRef): Boolean
-
def
!=
(arg0: Any): Boolean
-
def
##
(): Int
-
def
==
(arg0: AnyRef): Boolean
-
def
==
(arg0: Any): Boolean
-
def
asInstanceOf
[T0]
: T0
-
def
clone
(): AnyRef
-
implicit def
convertToClueful
[T]
(fun: ⇒ T): Clueful[T]
-
def
eq
(arg0: AnyRef): Boolean
-
def
equals
(arg0: Any): Boolean
-
def
finalize
(): Unit
-
def
getClass
(): java.lang.Class[_]
-
def
hashCode
(): Int
-
def
isInstanceOf
[T0]
: Boolean
-
def
ne
(arg0: AnyRef): Boolean
-
def
notify
(): Unit
-
def
notifyAll
(): Unit
-
def
synchronized
[T0]
(arg0: ⇒ T0): T0
-
def
toString
(): String
-
def
wait
(): Unit
-
def
wait
(arg0: Long, arg1: Int): Unit
-
def
wait
(arg0: Long): Unit
Inherited from AnyRef
Inherited from Any
Trait providing an implicit conversion that allows clues to be place after a block of code.
You can use the
withClueconstruct provided byAssertions, which is extended by every style trait in ScalaTest, to add extra information to reports of failed or canceled tests. ThewithCluefromAssertionsplaces the "clue string" at the front, both in the code and in the resulting message:The above expression will yield the failure message:
This is a prepended clue; 2 did not equal 3If you mix in this trait, or import its members via its companion object, you can alternatively place the clue string at the end, like this:
{ 1 + 1 should equal (3) } withClue "now the clue comes after"The above expression will yield the failure message:
2 did not equal 3 now the clue comes afterIf no space is already present, either at the beginning of the clue string or at the end of the current message, a space will be placed between the two, unless the clue string starts with one of the punctuation characters: comma (
,), period (.), or semicolon (;). For example, the failure message in the above example includes an extra space inserted between 3 and now.By contrast this code, which has a clue string starting with comma:
{ 1 + 1 should equal (3) } withClue ", now the clue comes after"Will yield a failure message with no extra inserted space:
2 did not equal 3, now the clue comes afterThe
withCluemethod will only append the clue string to the detail message of exception types that mix in theModifiableMessagetrait. See the documentation forModifiableMessagefor more information.Note: the reason this functionality is not provided by
Assertionsdirectly, like the prependedwithClueconstruct, is because appended clues require an implicit conversion. ScalaTest only gives you one implicit conversion by default in any test class to minimize the potential for conflicts with other implicit conversions you may be using. All other implicit conversions, including the one provided by this trait, you must explicitly invite into your code through inheritance or an import.