trait BePropertyMatcher[-T] extends (T) => BePropertyMatchResult
Trait extended by matcher objects, which may appear after the word be
, that can match against a Boolean
property. The match will succeed if and only if the Boolean
property equals true
.
The object containing the property, which must be of the type specified by the BePropertyMatcher
's type
parameter T
, is passed to the BePropertyMatcher
's
apply
method. The result is a BePropertyMatchResult
.
A BePropertyMatcher
is, therefore, a function from the specified type, T
, to
a BePropertyMatchResult
.
Although BePropertyMatcher
and Matcher
represent similar concepts, they have no inheritance relationship
because Matcher
is intended for use right after should
or must
whereas BePropertyMatcher
is intended for use right after be
.
A BePropertyMatcher
essentially allows you to write statically typed Boolean
property assertions similar to the dynamic ones that use symbols:
tempFile should be a ('file) // dynamic: uses reflection tempFile should be a (file) // type safe: only works on Files; no reflection used
One good way to organize custom matchers is to place them inside one or more traits that
you can then mix into the suites or specs that need them. Here's an example that
includes two BePropertyMatcher
s:
trait CustomMatchers {
class FileBePropertyMatcher extends BePropertyMatcher[java.io.File] { def apply(left: java.io.File) = BePropertyMatchResult(left.isFile, "file") }
class DirectoryBePropertyMatcher extends BePropertyMatcher[java.io.File] { def apply(left: java.io.File) = BePropertyMatchResult(left.isDirectory, "directory") }
val file = new FileBePropertyMatcher val directory = new DirectoryBePropertyMatcher }
Because the type parameter of these two BePropertyMatcher
s is java.io.File
, they
can only be used with instances of that type. (The compiler will enforce this.) All they do is create a
BePropertyMatchResult
whose matches
field is true
if and only if the Boolean
property
is true
. The second field, propertyName
, is simply the string name of the property.
The file
and directory
val
s create variables that can be used in
matcher expressions that test whether a java.io.File
is a file or a directory. Here's an example:
class ExampleSpec extends RefSpec with Matchers with CustomMatchers {
describe("A temp file") {
it("should be a file, not a directory") {
val tempFile = java.io.File.createTempFile("delete", "me")
try { tempFile should be a (file) tempFile should not be a (directory) } finally { tempFile.delete() } } } }
These matches should succeed, but if for example the first match, tempFile should be a (file)
, were to fail, you would get an error message like:
/tmp/delme1234me was not a file
For more information on BePropertyMatchResult
and the meaning of its fields, please
see the documentation for BePropertyMatchResult
. To understand why BePropertyMatcher
is contravariant in its type parameter, see the section entitled "Matcher's variance" in the
documentation for Matcher
.
- Self Type
- BePropertyMatcher[T]
- Source
- BePropertyMatcher.scala
- Alphabetic
- By Inheritance
- BePropertyMatcher
- Function1
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Abstract Value Members
- abstract def apply(objectWithProperty: T): BePropertyMatchResult
Check to see if a
Boolean
property on the specified object,objectWithProperty
, matches its expected value, and report the result in the returnedBePropertyMatchResult
.Check to see if a
Boolean
property on the specified object,objectWithProperty
, matches its expected value, and report the result in the returnedBePropertyMatchResult
. TheobjectWithProperty
is usually the value to the left of ashould
ormust
invocation. For example,tempFile
would be passed as theobjectWithProperty
in:tempFile should be a (file)
- objectWithProperty
the object with the
Boolean
property against which to match- returns
the
BePropertyMatchResult
that represents the result of the match
- Definition Classes
- BePropertyMatcher → Function1
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- def andThen[A](g: (BePropertyMatchResult) => A): (T) => A
- Definition Classes
- Function1
- Annotations
- @unspecialized()
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- def compose[U](g: (U) => T): BePropertyMatcher[U]
Compose this
BePropertyMatcher
with the passed function, returning a newBePropertyMatcher
.Compose this
BePropertyMatcher
with the passed function, returning a newBePropertyMatcher
.This method overrides
compose
onFunction1
to return a more specific function type ofBePropertyMatcher
.- Definition Classes
- BePropertyMatcher → Function1
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def toString(): String
- Definition Classes
- Function1 → AnyRef → Any
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()