В Scala Specs, что такое функция "must"? - PullRequest
3 голосов
/ 23 марта 2011

Я работаю с некоторыми тестами Specs и пытаюсь понять, что такое функция must, и для чего она нужна.

Я не могу найти ни одного объявления или реализации в спецификацииисточник, и я пытаюсь понять, что он делает.

Вот несколько примеров его использования:

"hello world".size must be equalTo(11)
"hello world" must be matching("h.* w.*")
stack.push(11) must throwAn[Error]

Мне кажется, что «должен» принимает функцию в качестве аргумента, но я хотел бы знать фактическую подпись «must» и что она делает со своим аргументом.

Может кто-нибудь указать мне правильное направление?

Спасибо!

Ответы [ 2 ]

6 голосов
/ 23 марта 2011

По крайней мере, в Specs2.0 вы найдете определение must в org.specs2.matcher.MustExpectable

/**
 * This kind of expectable can be followed by the verb must to apply a matcher:
 * 
 * `1 must beEqualTo(1)`
 * 
 * For convenience, several mustMatcher methods have also been defined as shortcuts to equivalent:
 * 
 * `a must matcher`
 */
class MustExpectable[T] private[specs2] (tm: () => T) extends Expectable[T](tm) { outer =>
  def must(m: =>Matcher[T]) = applyMatcher(m)
  def must_==(other: =>T) = applyMatcher(new BeEqualTo(other))
  def must_!=(other: =>T) = applyMatcher(new BeEqualTo(other).not)
}
object MustExpectable {
  def apply[T](t: =>T) = new MustExpectable(() => t)
}

MustExpectation черта здесь для объявления соответствующих неявных преобразований:

/**
 * This trait provides implicit definitions to transform any value into a MustExpectable
 */
trait MustExpectations extends Expectations {
  implicit def akaMust[T](tm: Expectable[T]) = new MustExpectable(() => tm.value) {
    override private[specs2] val desc = tm.desc
  }
  implicit def theValue[T](t: =>T): MustExpectable[T] = createMustExpectable(t)
  implicit def theBlock(t: =>Nothing): MustExpectable[Nothing] = createMustExpectable(t)

  protected def createMustExpectable[T](t: =>T) = MustExpectable(t)
}
object MustExpectations extends MustExpectations
2 голосов
/ 23 марта 2011

Документация по MustMatchers есть, есть подробные объяснения по использованию must и should.

...