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: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

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

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

    Definition Classes
    Any
  6. 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

  7. 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

  8. 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

  9. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  10. def clone(): AnyRef

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

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

    Definition Classes
    AnyRef → Any
  13. 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

  14. def eventually: Matcher[T]

    returns

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

  15. 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
  16. def finalize(): Unit

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

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

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

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

  20. final def isInstanceOf[T0]: Boolean

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

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

  22. def mute: Matcher[T]

    returns

    a Matcher with no messages

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

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

    negate a Matcher

    negate a Matcher

    See also

    MatchResult.not

  25. final def notify(): Unit

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

    Definition Classes
    AnyRef
  27. 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

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

    returns

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

  29. 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

  30. def orPending: Matcher[T]

    returns

    a Pending MatchResult if this matcher fails

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

    returns

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

  32. 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

  33. def orSkip: Matcher[T]

    returns

    a Skip MatchResult if this matcher fails

  34. 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
  35. 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
  36. 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
  37. 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
  38. 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
  39. def setMessage(message: String): Matcher[T]

    returns

    set a new failure message of a matcher

  40. 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
  41. final def synchronized[T0](arg0: ⇒ T0): T0

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

    returns

    a test function corresponding to this matcher

  43. def toString(): String

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

    only apply this matcher if the condition is false

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

    returns

    update the failure message of a matcher

  46. final def wait(): Unit

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

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

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

    only apply this matcher if the condition is true

Inherited from AnyRef

Inherited from Any

Ungrouped