org.specs2.matcher

Matcher

trait Matcher[-T] extends AnyRef

The Matcher trait is the base trait for any Matcher.

This trait can be extended to provide an appropriate apply method that will check an expectable value a: Expectable[T].

The result of a match is a MatchResult object (@see MatchResult).

Matchers can be composed.

Implementation notes:

Self Type
Matcher[T]
Linear Supertypes
AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Matcher
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Abstract Value Members

  1. abstract def apply[S <: T](t: Expectable[S]): MatchResult[S]

    apply this matcher to an Expectable

    apply this matcher to an Expectable

    returns

    a MatchResult describing the outcome of the match

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  4. def ^^[S](f: (S) ⇒ Expectable[T], dummy: Int = 0): Matcher[S]

    Adapt a matcher to another.

    Adapt a matcher to another. ex: be_==("message") ^^ (_.getMessage aka "trimmed") can be applied to an exception

    The dummy value is used to help to disambiguate with the overloaded ^^ function

  5. def ^^[S](f: (S) ⇒ T): Matcher[S]

    Adapt a matcher to another.

    Adapt a matcher to another. ex: be_==("message") ^^ (_.getMessage) can be applied to an exception

  6. def and[S <: T](m: ⇒ Matcher[S]): Matcher[S]

    the logical and between 2 matchers

    the logical and between 2 matchers

    See also

    MatchResult.and

  7. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  8. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  9. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  10. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  11. def eventually(retries: Int, sleep: Duration): Matcher[T]

    returns

    a matcher that needs to eventually match, after a given number of retries and a sleep time

  12. def eventually: Matcher[T]

    returns

    a matcher that needs to eventually match, after 40 retries and a sleep time of 100 milliseconds

  13. def failure[S <: T](message: ⇒ String, value: Expectable[S]): MatchResult[S]

    This method can be used to create a failed match result

    This method can be used to create a failed match result

    Attributes
    protected
  14. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  15. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  16. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  17. def iff(b: Boolean): Matcher[T]

    when the condition is true the matcher is applied, when it's false, the matcher must fail

  18. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  19. def lazily: Matcher[() ⇒ T]

    The lazily operator returns a Matcher which will match a function returning the expected value

  20. def mute: Matcher[T]

    returns

    a Matcher with no messages

  21. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  22. def not: Matcher[T]

    negate a Matcher

    negate a Matcher

    See also

    MatchResult.not

  23. final def notify(): Unit

    Definition Classes
    AnyRef
  24. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  25. def or[S <: T](m: ⇒ Matcher[S]): Matcher[S]

    the logical or between 2 matchers

    the logical or between 2 matchers

    See also

    MatchResult.or

  26. def orPending(message: (String) ⇒ String): Matcher[T]

    returns

    a Pending MatchResult if this matcher fails, modifying the failure message with a pending message.

  27. def orPending(m: String): Matcher[T]

    returns

    a Pending MatchResult if this matcher fails, prefixing the failure message with a pending message. If the pending message is empty, only the failure message is printed

  28. def orPending: Matcher[T]

    returns

    a Pending MatchResult if this matcher fails

  29. def orSkip(message: (String) ⇒ String): Matcher[T]

    returns

    a Skip MatchResult if this matcher fails, modifying the failure message with a skip message.

  30. def orSkip(m: String): Matcher[T]

    returns

    a Skip MatchResult if this matcher fails, prefixing the failure message with a skip message. If the skip message is empty, only the failure message is printed

  31. def orSkip: Matcher[T]

    returns

    a Skip MatchResult if this matcher fails

  32. def result[S <: T](other: MatchResultMessages.MatchResultMessage, value: Expectable[S]): MatchResult[S]

    returns

    a MatchResult using the messages embedded in a MatchResultMessage (i.e. an accumulation of messages from other matches)

    Attributes
    protected
  33. def result[S <: T](other: Result, value: Expectable[S]): MatchResult[S]

    returns

    a Match Result from another result

    Attributes
    protected
  34. def result[S <: T](other: MatchResult[_], value: Expectable[S]): MatchResult[S]

    returns

    a MatchResult copied on another one, but with a different expectable

    Attributes
    protected
  35. def result[S <: T](test: ⇒ Boolean, okMessage: ⇒ String, koMessage: ⇒ String, value: Expectable[S], expected: String, actual: String): MatchResult[S]

    This method can be used to evaluate a boolean condition and return an appropriate MatchResult

    This method can be used to evaluate a boolean condition and return an appropriate MatchResult

    returns

    a MatchResult with an okMessage, a koMessage, the expectable value and the expected/actual values as string to display a failure comparison if necessary

    Attributes
    protected
  36. def result[S <: T](triplet: ⇒ (Boolean, String, String), value: Expectable[S]): MatchResult[S]

    This method uses a triplet instead of separated arguments

    This method uses a triplet instead of separated arguments

    returns

    a MatchResult with an okMessage, a koMessage and the expectable value

    Attributes
    protected
  37. def result[S <: T](test: ⇒ Boolean, okMessage: ⇒ String, koMessage: ⇒ String, value: Expectable[S]): MatchResult[S]

    This method can be used to evaluate a boolean condition and return an appropriate MatchResult

    This method can be used to evaluate a boolean condition and return an appropriate MatchResult

    returns

    a MatchResult with an okMessage, a koMessage and the expectable value

    Attributes
    protected
  38. def setMessage(message: String): Matcher[T]

    returns

    set a new failure message of a matcher

  39. def success[S <: T](message: ⇒ String, value: Expectable[S]): MatchResult[S]

    This method can be used to create a successful match result

    This method can be used to create a successful match result

    Attributes
    protected
  40. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  41. def test: (T) ⇒ Boolean

    returns

    a test function corresponding to this matcher

  42. def toString(): String

    Definition Classes
    AnyRef → Any
  43. def unless(b: Boolean, m: String = ""): Matcher[T]

    only apply this matcher if the condition is false

  44. def updateMessage(f: (String) ⇒ String): Matcher[T]

    returns

    update the failure message of a matcher

  45. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  46. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  47. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  48. def when(b: Boolean, m: String = ""): Matcher[T]

    only apply this matcher if the condition is true

Inherited from AnyRef

Inherited from Any

Ungrouped