OneAppPerSuite

Trait that provides a new FakeApplication instance per ScalaTest Suite.

By default, this trait creates a new FakeApplication for the Suite using default parameter values, which is made available via the app field defined in this trait. If your Suite needs a FakeApplication with non-default parameters, override app to create it the way you need it.

This SuiteMixin trait's overridden run method calls Play.start, passing in the FakeApplication provided by app, before executing the Suite via a call to super.run. In addition, it places a reference to the FakeApplication provided by app into the ConfigMap under the key org.scalatestplus.play.app. This allows any nested Suites to access the Suite's FakeApplication as well, most easily by having the nested Suites mix in the ConfiguredApp trait. On the status returned by super.run, this trait's overridden run method registers a call to Play.stop to be executed when the Status completes, and returns the same Status. This ensure the FakeApplication will continue to execute until all nested suites have completed, after which the FakeApplication will be stopped.

Here's an example that demonstrates some of the services provided by this trait:

package org.scalatestplus.play.examples.oneapppersuite

import play.api.test._
import org.scalatest._
import org.scalatestplus.play._
import play.api.{Play, Application}

class ExampleSpec extends PlaySpec with OneAppPerSuite {

  // Override app if you need a FakeApplication with other than non-default parameters.
  implicit override lazy val app: FakeApplication =
    FakeApplication(additionalConfiguration = Map("ehcacheplugin" -> "disabled"))

  "The OneAppPerSuite trait" must {
    "provide a FakeApplication" in {
      app.configuration.getString("ehcacheplugin") mustBe Some("disabled")
    }
    "make the FakeApplication available implicitly" in {
      def getConfig(key: String)(implicit app: Application) = app.configuration.getString(key)
      getConfig("ehcacheplugin") mustBe Some("disabled")
    }
    "start the FakeApplication" in {
      Play.maybeApplication mustBe Some(app)
    }
  }
}

If you have many tests that can share the same `FakeApplication`, and you don't want to put them all into one test class, you can place them into different `Suite` classes. These will be your nested suites. Create a master suite that extends `OneAppPerSuite` and declares the nested `Suite`s. Annotate the nested suites with `@DoNotDiscover` and have them extend `ConfiguredApp`. Here's an example:

package org.scalatestplus.play.examples.oneapppersuite

import play.api.test._
import org.scalatest._
import org.scalatestplus.play._
import play.api.{Play, Application}

// This is the "master" suite
class NestedExampleSpec extends Suites(
  new OneSpec,
  new TwoSpec,
  new RedSpec,
  new BlueSpec
) with OneAppPerSuite {
  // Override app if you need a FakeApplication with other than non-default parameters.
  implicit override lazy val app: FakeApplication =
    FakeApplication(additionalConfiguration = Map("ehcacheplugin" -> "disabled"))
}

// These are the nested suites
@DoNotDiscover class OneSpec extends PlaySpec with ConfiguredApp
@DoNotDiscover class TwoSpec extends PlaySpec with ConfiguredApp
@DoNotDiscover class RedSpec extends PlaySpec with ConfiguredApp

@DoNotDiscover
class BlueSpec extends PlaySpec with ConfiguredApp {

  "The OneAppPerSuite trait" must {
    "provide a FakeApplication" in {
      app.configuration.getString("ehcacheplugin") mustBe Some("disabled")
    }
    "make the FakeApplication available implicitly" in {
      def getConfig(key: String)(implicit app: Application) = app.configuration.getString(key)
      getConfig("ehcacheplugin") mustBe Some("disabled")
    }
    "start the FakeApplication" in {
      Play.maybeApplication mustBe Some(app)
    }
  }
}

Self Type: OneAppPerSuite with Suite

Linear Supertypes

SuiteMixin, AnyRef, Any

Abstract Value Members

abstract def expectedTestCount(filter: Filter): Int

Definition Classes
SuiteMixin
abstract def nestedSuites: IndexedSeq[Suite]

Definition Classes
SuiteMixin
abstract def rerunner: Option[String]

Definition Classes
SuiteMixin
abstract def runNestedSuites(args: Args): Status

Attributes
protected
Definition Classes
SuiteMixin
abstract def runTest(testName: String, args: Args): Status

Attributes
protected
Definition Classes
SuiteMixin
abstract def runTests(testName: Option[String], args: Args): Status

Attributes
protected
Definition Classes
SuiteMixin
abstract val styleName: String

Definition Classes
SuiteMixin
abstract def suiteId: String

Definition Classes
SuiteMixin
abstract def suiteName: String

Definition Classes
SuiteMixin
abstract def tags: Map[String, Set[String]]

Definition Classes
SuiteMixin
abstract def testDataFor(testName: String, theConfigMap: ConfigMap): TestData

Definition Classes
SuiteMixin
abstract def testNames: Set[String]

Definition Classes
SuiteMixin
abstract def withFixture(test: (OneAppPerSuite.this)#NoArgTest): Outcome

Attributes
protected
Definition Classes
SuiteMixin

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def !=(arg0: Any): Boolean

Definition Classes
Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def ==(arg0: Any): Boolean

Definition Classes
Any
implicit lazy val app: FakeApplication

An implicit instance of FakeApplication.
An implicit instance of FakeApplication.
This trait's implementation initializes this lazy val with a new instance of FakeApplication with parameters set to their defaults. Override this lazy val if you need a FakeApplication created with non-default parameter values.
final def asInstanceOf[T0]: T0

Definition Classes
Any
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
def run(testName: Option[String], args: Args): Status

Invokes Play.start, passing in the FakeApplication provided by app, and places that same FakeApplication into the ConfigMap under the key org.scalatestplus.play.app to make it available to nested suites; calls super.run; and lastly ensures Play.stop is invoked after all tests and nested suites have completed.
Invokes Play.start, passing in the FakeApplication provided by app, and places that same FakeApplication into the ConfigMap under the key org.scalatestplus.play.app to make it available to nested suites; calls super.run; and lastly ensures Play.stop is invoked after all tests and nested suites have completed.
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.
args
the Args for this run
returns
a Status object that indicates when all tests and nested suites started by this method have completed, and whether or not a failure occurred.

Definition Classes
OneAppPerSuite → SuiteMixin
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def toString(): String

Definition Classes
AnyRef → Any
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

trait OneAppPerSuite extends SuiteMixin

Abstract Value Members

abstract def expectedTestCount(filter: Filter): Int

abstract def nestedSuites: IndexedSeq[Suite]

abstract def rerunner: Option[String]

abstract def runNestedSuites(args: Args): Status

abstract def runTest(testName: String, args: Args): Status

abstract def runTests(testName: Option[String], args: Args): Status

abstract val styleName: String

abstract def suiteId: String

abstract def suiteName: String

abstract def tags: Map[String, Set[String]]

abstract def testDataFor(testName: String, theConfigMap: ConfigMap): TestData

abstract def testNames: Set[String]

abstract def withFixture(test: (OneAppPerSuite.this)#NoArgTest): Outcome

Concrete Value Members

final def !=(arg0: AnyRef): Boolean

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: AnyRef): Boolean

final def ==(arg0: Any): Boolean

implicit lazy val app: FakeApplication

final def asInstanceOf[T0]: T0

def clone(): AnyRef

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

final def getClass(): Class[_]

def hashCode(): Int

final def isInstanceOf[T0]: Boolean

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

def run(testName: Option[String], args: Args): Status

final def synchronized[T0](arg0: ⇒ T0): T0

def toString(): String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

Inherited from SuiteMixin

Inherited from AnyRef

Inherited from Any

Ungrouped