org.scalatest.ConfigMapWrapperSuite.scala Maven / Gradle / Ivy
Show all versions of scalatest_2.11.0-M3 Show documentation
package org.scalatest
/**
* Wrapper Suite that passes an instance of the config map to the constructor of the
* wrapped Suite when run is invoked.
*
*
* Each time run is invoked on an instance of ConfigMapWrapperSuite, this
* suite will create a new instance of the suite to wrap, passing to the constructor the config map passed to
* run. This way, if the same ConfigMapWrapperSuite instance is run multiple
* times, each time with a different config map, an instance of the wrapped suite will be created
* for each config map. In addition to being passed to the wrapped suite's constructor, the config map passed
* to the ConfigMapWrapperSuite's run method will also be passed to the run
* method of the newly created wrapped suite instance.
*
*
*
* The config map is accessible inside a Suite in many ways. It is passed to run,
* runNestedSuites, runTests, and runTest. It is also passed to
* withFixture, accessible via a method on NoArgTest and
* OneArgTest.
* It is passed to an overloaded forms of the beforeEach and afterEach methods of trait
* BeforeAndAfterEach, as well as overloaded forms of the beforeAll and
* afterAll methods of trait BeforeAndAfterAll. Tests themselves can have information
* taken from the config map, or the entire config map, through various means. The config map may be passed into
* the test via a ConfigMapFixture, for example. Class ConfigMapWrapperSuite
* represents one more way to get at the config map inside a suite of test: ConfigMapWrapperSuite will
* pass the config map to the constructor of your suite class, bringing it easily into scope for tests and
* helper methods alike.
*
*
*
* Having the config map passed to the suite constructor might be more convenient in some cases, but in the case
* of the org.scalatest.path traits, it is necessary if a test needs
* information from a config map. The reason is that in a path trait, the test code is executed eagerly,
* before run is invoked. The results of the tests are registered when the tests are executed, and those
* results are merely reported once run is invoked. Thus by the time run has been invoked, it
* is too late to get the config map to the tests, which have already been executed. Using a ConfigMapWrapperSuite solves that problem.
* By passing the config map to the constructor, it is available early enough for the running tests to use it.
* Here's an example:
*
*
*
* import org.scalatest._
*
* @WrapWith(classOf[ConfigMapWrapperSuite])
* class ExampleSpec(configMap: Map[String, Any]) extends path.FunSpec {
*
* describe("A widget database") {
* it("should contain consistent values") {
* val dbName = configMap("WidgetDbName") // Can access config map
* // ...
* }
* }
* }
*
*
* @author Bill Venners
*/
final class ConfigMapWrapperSuite(clazz: Class[_ <: Suite]) extends Suite {
private lazy val wrappedSuite = {
val constructor = clazz.getConstructor(classOf[Map[_, _]])
constructor.newInstance(Map.empty)
}
/**
* Returns the result obtained from invoking expectedTestCount on an instance of the wrapped
* suite, constructed by passing an empty config map to its constructor, passing into the wrapped suite's
* expectedTestCount method the specified Filter.
*
* @param filter the Filter to pass to the wrapped suite's expectedTestCount method
* @return the result of invoking expectedTestCount on an instance of wrapped suite
*/
override def expectedTestCount(filter: Filter): Int = wrappedSuite.expectedTestCount(filter)
/**
* Returns the result obtained from invoking testNames on an instance of the wrapped
* suite, constructed by passing an empty config map to its constructor.
*
* @return the result of invoking testNames on an instance of wrapped suite
*/
override def testNames: Set[String] = wrappedSuite.testNames
/**
* Returns the result obtained from invoking nestedSuites on an instance of the wrapped
* suite, constructed by passing an empty config map to its constructor.
*
* @return the result of invoking nestedSuites on an instance of wrapped suite
*/
override def nestedSuites: List[Suite] = wrappedSuite.nestedSuites
/**
* Returns the result obtained from invoking tags on an instance of the wrapped
* suite, constructed by passing an empty config map to its constructor.
*
* @return the result of invoking testNames on an instance of wrapped suite
*/
override def tags: Map[String, Set[String]] = wrappedSuite.tags
/**
* Constructs a new instance of the suite to wrap, whose Class is passed to this
* suite's constructor, passing in the specified config map, and invokes run on
* that new instance, passing in the same arguments passed to this method.
*
* @param testName an optional name of one test to run. If None, all relevant tests should be run.
* I.e., None acts like a wildcard that means run all relevant tests in this Suite.
* @param reporter the Reporter to which results will be reported
* @param stopper the Stopper that will be consulted to determine whether to stop execution early.
* @param filter a Filter with which to filter tests based on their tags
* @param configMap a Map of key-value pairs that can be used by the executing Suite
* of tests (passed to both the constructor of the wrapped suite and its run method).
* @param distributor an optional Distributor, into which to put nested Suites to be run
* by another entity, such as concurrently by a pool of threads. If None, nested Suites will be run sequentially.
* @param tracker a Tracker tracking Ordinals being fired by the current thread.
*
* @throws NullPointerException if any passed parameter is null.
* @throws IllegalArgumentException if testName is defined, but no test with the specified test name
* exists in this Suite
*/
override def run(testName: Option[String], reporter: Reporter, stopper: Stopper, filter: Filter,
configMap: Map[String, Any], distributor: Option[Distributor], tracker: Tracker) {
val constructor = clazz.getConstructor(classOf[Map[_, _]])
val suite = constructor.newInstance(configMap)
suite.run(testName, reporter, stopper, filter, configMap, distributor, tracker)
}
}