| Deletions are marked like this. | Additions are marked like this. |
| Line 194: | Line 194: |
| Line 196: | Line 197: |
|
Debugging If faced with a difficult to debug failing expectation, consider mixing one or both of the VerboseErrors or CallLogging traits into your test suite: |
失敗するエクスペクテーションのデバッグが困難であれば、「VerboseErrors」あるいは「CallLogging」のいずれかあるいは両方をミックスしてみてほしい。 {{{ |
| Line 201: | Line 202: |
|
Visibility Public All Type Members trait AbstractMockFactory extends ProxyMockFactory trait CallLogging extends AnyRef Trait that can be mixed into a AbstractMockFactory to switch on call logging. class Expectation extends Handler Represents a single expectation case class ExpectationException (msg: String) extends RuntimeException with Product with Serializable class MatchAny extends Equals class MatchEpsilon extends Equals trait Mock extends AnyRef class MockFunction extends AnyRef class MockFunction0 [R] extends MockFunction with () ⇒ R class MockFunction1 [T1, R] extends MockFunction with (T1) ⇒ R class MockFunction10 [T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, R] extends MockFunction with (T1, T2, T3, T4, T5, T6, T7, T8, T9, T10) ⇒ R class MockFunction2 [T1, T2, R] extends MockFunction with (T1, T2) ⇒ R class MockFunction3 [T1, T2, T3, R] extends MockFunction with (T1, T2, T3) ⇒ R class MockFunction4 [T1, T2, T3, T4, R] extends MockFunction with (T1, T2, T3, T4) ⇒ R class MockFunction5 [T1, T2, T3, T4, T5, R] extends MockFunction with (T1, T2, T3, T4, T5) ⇒ R class MockFunction6 [T1, T2, T3, T4, T5, T6, R] extends MockFunction with (T1, T2, T3, T4, T5, T6) ⇒ R class MockFunction7 [T1, T2, T3, T4, T5, T6, T7, R] extends MockFunction with (T1, T2, T3, T4, T5, T6, T7) ⇒ R class MockFunction8 [T1, T2, T3, T4, T5, T6, T7, T8, R] extends MockFunction with (T1, T2, T3, T4, T5, T6, T7, T8) ⇒ R class MockFunction9 [T1, T2, T3, T4, T5, T6, T7, T8, T9, R] extends MockFunction with (T1, T2, T3, T4, T5, T6, T7, T8, T9) ⇒ R trait ProxyMockFactory extends AnyRef trait VerboseErrors extends AnyRef Trait that can be mixed into a AbstractMockFactory to switch on verbose error messages. Value Members object MatchEpsilon extends AnyRef package junit3 package scalatest package specs2 |
}}} |
本家scaladocの翻訳
以下は2011/7/2時点のhttp://borachio.com/api/com/borachio/package.htmlの翻訳
Borachio: Native Scala mocking
ScalaTestでBorachioを使うには、suiteにMockFactoryトレイトをミックスする。
class MyTest extends Suite with MockFactory
JUnit3にて使うには同じくMockFactoryをTestCaseにミックスする。
class MyTest extends TestCase with MockFactory
Borachioは二つのモックスタイルをサポートする。ファンクショナルモッキングとプロキシモッキングである。
ファンクショナルモッキング
ファンクショナルモックはmockFunctionを使って生成される。例えば以下では一つのInt引数をとり、Stringを返すモック関数を作成する。
val m = mockFunction[Int, String]
そしてこのモックファンクションにエクスペクテーションを設定する。 例えば以下では、このモックが一度だけ42という引数で呼び出され、"Forty two"を返すものとする。
m expects (42) returning "Forty two" once
プロキシモッキング
mock（関数）によってプロキシモックを作成する。例えば以下は、Turtleトレイト（インターフェース）のすべてを実装するモックを作成する。
val m = mock[Turtle]
そしてそれぞれのメソッドについてのエクスペクテーションをセットすることができる。例えば
m expects 'setPosition withArgs (10.0, 10.0) m expects 'forward withArgs (5.0) m expects 'getPosition returning (15.0, 10.0)
エクスペクテーション
フ関数やメソッドがどのような引数で何度呼ばれるべきであるかをエクスペクテーションとしてセットすることができる。 加えて、モックはそのエクスペクテーションが成立する場合にどのような値を返すか、あるいは例外を発生するかを指定することができる。
引数
ファンクショナルモックに期待される引数を指定するにはexpectsを用いる。 プロキシモックにはwithArgsあるいはwithArgumentsを用いる。
期待する引数の指定がなければ、モックはいかなる引数をも受け入れる。
単純な等価性テストのための引数を指定する場合は、それらをタプルとして指定する（訳注：？）
m expects ("this", "that")Borachioは現在のところ、二つのタイプの一般化マッチングをサポートしている。 ワイルドカードとイプシロンマッチングである。
ワイルドカード
ワイルドカード値は、*(アスタリスク）で表す。例えば
m expects ("this", *)は次にマッチする。
m("this", 42)
m("this", 1.0)
m("this", null)
イプシロンマッチング
イプシロンマッチングは浮動小数点数値を扱う場合に便利だ。 イプシロンマッチは~（チルダ）オペレータで表される。
m expects (~42.0)
は次にマッチする。
m(42.0) m(42.0001) m(41.9999)
が次にはマッチしない。
m(43.0) m(42.1)
返り値
モックの返り値をreturnsあるいはreturningを使って指定することができる。
m1 returns 42
m2 expects ("this", "that") returning "the other"返り値が指定されない場合、ファンクショナルモックはnull.asInstanceOf[R]を返すが、Rは返り値のタイプである（つまり、Intの場合は0、Doubleの場合は0.0など）。
プロキシモックの場合はnullを返す。 これは多くの返り値型について正しく動作するが、プリミティブタイプ（Int, Double等）の場合にはそうはいかない。nullを返すとNullPointerExceptionが発生してしまうのである。 だから、このようなメソッドについては明示的に返り値を指定した方がよい。この制限は将来緩和されるかもしれない。
例外
値を返す代わりに例外を投げさせることもできる。
m expects ("this", "that") throws new RuntimeException("what's that?")
呼び出し回数
デフォルトでは、モックは１回以上呼び出されることを期待する（つまり、全く呼び出されない場合は「失敗」になる）。 repeatを使って正確な呼び出し回数を指定することができる。
m1 returns 42 repeat 3 to 7 m2 expects (3) repeat 10
これについては、様々な別の書き方もできる。
m1 expects ("this", "that") once
m2 returns "foo" noMoreThanTwice
m3 expects (42) repeated 3 timesすべてのリストは「Expectation」を参照して欲しい。
順序
デフォルトでは、エクスペクテーションはどのような順序であってもよい。例えば、
m expects (1) m expects (2) m(2) m(1)
特定の順序はinSequenceによって強制することができる。
inSequence {
m expects (1)
m expects (2)
}
m(2) // throws ExpectationException
m(1)複数のシーケンスも指定することができる。 それぞれのシーケンスにおいて正しい順序である限り、異なるシーケンスの順序はまぜこぜでよい。 例えば、
val m1 = mock[Turtle]
val m2 = mock[Turtle]
inSequence {
m1 expects 'setPosition withArguments (0.0, 0.0)
m1 expects 'penDown
m1 expects 'forward withArguments (10.0)
m1 expects 'penUp
}
inSequence {
m2 expects 'setPosition withArguments(1.0, 1.0)
m2 expects 'turn withArguments (90.0)
m2 expects 'forward withArguments (1.0)
m2 expects 'getPosition returning (2.0, 1.0)
}
m2.setPosition(1.0, 1.0)
m1.setPosition(0.0, 0.0)
m1.penDown
m2.turn(90.0)
m1.forward(10.0)
m2.forward(1.0)
m1.penUp
expect((2.0, 1.0)) { m2.getPosition }
デバッグ
失敗するエクスペクテーションのデバッグが困難であれば、「VerboseErrors」あるいは「CallLogging」のいずれかあるいは両方をミックスしてみてほしい。
class MyTest extends Suite with MockFactory with VerboseErrors with CallLogging