org.scalatest.junit.ShouldMatchersForJUnit.scala Maven / Gradle / Ivy
Show all versions of scalatest_2.11.0-RC2 Show documentation
/*
* Copyright 2001-2013 Artima, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.scalatest.junit
import org.scalatest._
import _root_.junit.framework.AssertionFailedError
/**
* Trait that makes ScalaTest's ShouldMatchers DSL syntax available for use with JUnit.
*
*
* The assertion methods provided in this trait look and behave exactly like the ones in
* ShouldMatchers, except instead of throwing
* TestFailedException they throw
* JUnitTestFailedError,
* which extends junit.framework.AssertionFailedError.
*
*
* JUnit 3 (release 3.8 and earlier) distinguishes between failures and errors.
* If a test fails because of a failed assertion, that is considered a failure. If a test
* fails for any other reason, either the test code or the application being tested threw an unexpected
* exception, that is considered an error. The way JUnit 3 decides whether an exception represents
* a failure or error is that only thrown junit.framework.AssertionFailedErrors are considered
* failures. Any other exception type is considered an error. The exception type thrown by the JUnit 3
* assertion methods declared in junit.framework.Assert (such as assertEquals,
* assertTrue, and fail) is, therefore, AssertionFailedError.
*
*
*
* In JUnit 4, AssertionFailedError was made to extend java.lang.AssertionError,
* and the distinction between failures and errors was essentially dropped. However, some tools that integrate
* with JUnit carry on this distinction, so even if you are using JUnit 4 you may want to use this
* ShouldMatchersForJUnit trait instead of plain-old ScalaTest
* ShouldMatchers.
*
*
*
* To use this trait in a JUnit 3 TestCase, you can mix it into your TestCase class, like this:
*
*
*
* import junit.framework.TestCase
* import org.scalatest.junit.ShouldMatchersForJUnit
*
* class MyTestCase extends TestCase with ShouldMatchersForJUnit {
*
* def testSomething() {
* "hello, world!" should startWith ("hello")
* }
*
* // ...
* }
*
*
*
* You can alternatively import the methods defined in this trait.
*
*
*
* import junit.framework.TestCase
* import org.scalatest.junit.ShouldMatchersForJUnit._
*
* class MyTestCase extends TestCase {
*
* def testSomething() {
* "hello, world!" should startWith ("hello")
* }
*
* // ...
* }
*
*
*
* For details on the importing approach, see the documentation
* for the ShouldMatchersForJUnit companion object.
* For the details on the ShouldMatchersForJUnit syntax, see the Scaladoc documentation for
* org.scalatest.matchers.ShouldMatchers
*
*
* @author Bill Venners
*/
@deprecated("Please use org.scalatest.Matchers with AssertionsForJUnit instead.")
trait ShouldMatchersForJUnit extends org.scalatest.Matchers with AssertionsForJUnit
/**
* Companion object that facilitates the importing of ShouldMatchersForJUnit members as
* an alternative to mixing it in. One use case is to import ShouldMatchersForJUnit members so you can use
* them in the Scala interpreter:
*
*
* Macintosh-65:delus bv$ scala -cp .:../target/jar_contents:junit3.8.2/junit.jar
* Welcome to Scala version 2.7.5.final (Java HotSpot(TM) Client VM, Java 1.5.0_16).
* Type in expressions to have them evaluated.
* Type :help for more information.
*
* scala> import org.scalatest.junit.ShouldMatchersForJUnit._
* import org.scalatest.junit.ShouldMatchersForJUnit._
*
* scala> "hi" should have length (3)
* junit.framework.AssertionFailedError: "hi" had length 2 instead of expected length 3
* at org.scalatest.junit.ShouldMatchersForJUnit$class.newTestFailedException(ShouldMatchersForJUnit.scala:22)
* at org.scalatest.junit.ShouldMatchersForJUnit$.newTestFailedException(ShouldMatchersForJUnit.scala:63)
* at org.scalatest.matchers.Matchers$ResultOfHaveWordForString.length(Matchers.scala:4102)
* at .( 1 should equal (2)
* junit.framework.AssertionFailedError: 1 did not equal 2
* at org.scalatest.junit.ShouldMatchersForJUnit$class.newTestFailedException(ShouldMatchersForJUnit.scala:22)
* at org.scalatest.junit.ShouldMatchersForJUnit$.newTestFailedException(ShouldMatchersForJUnit.scala:63)
* at org.scalatest.matchers.ShouldMatchers$ShouldMethodHelper$.shouldMatcher(ShouldMatchers.scala:800)
* at org.scal...
* scala> "hello, world" should startWith ("hello")
*
* scala> 7 should (be >= (3) and not be <= (7))
* junit.framework.AssertionFailedError: 7 was greater than or equal to 3, but 7 was less than or equal to 7
* at org.scalatest.junit.ShouldMatchersForJUnit$class.newTestFailedException(ShouldMatchersForJUnit.scala:22)
* at org.scalatest.junit.ShouldMatchersForJUnit$.newTestFailedException(ShouldMatchersForJUnit.scala:63)
* at org.scalatest.matchers.ShouldMatchers$ShouldMethodHelper$.sh...
*
*
* @author Bill Venners
*/
@deprecated("Please use org.scalatest.Matchers with AssertionsForJUnit instead.")
object ShouldMatchersForJUnit extends ShouldMatchersForJUnit