trait OneAppPerSuiteWithComponents extends BaseOneAppPerSuite with WithApplicationComponents with FakeApplicationFactory
An extension of BaseOneAppPerSuite providing Compile-time DI.
Provides a new Application
instance per ScalaTest Suite
.
By default, this trait creates a new Application
for the Suite
according to the components defined in the test.
This TestSuiteMixin
trait's overridden run
method calls Play.start
, passing in the
Application
provided by app
, before executing the Suite
via a call to super.run
.
In addition, it places a reference to the Application
provided by app
into the ConfigMap
under the key org.scalatestplus.play.app
. This allows any nested Suite
s to access the Suite
's
Application
as well, most easily by having the nested Suite
s 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 Application
will continue to execute until
all nested suites have completed, after which the Application
will be stopped.
Here's an example that demonstrates some of the services provided by this trait:
import org.scalatestplus.play.PlaySpec import org.scalatestplus.play.components.OneServerPerSuiteWithComponents import play.api._ import play.api.mvc.Result import play.api.test.Helpers._ import play.api.test.{FakeRequest, Helpers} import scala.concurrent.Future class ExampleComponentsSpec extends PlaySpec with OneServerPerSuiteWithComponents { override def components: BuiltInComponents = new BuiltInComponentsFromContext(context) with NoHttpFiltersComponents { import play.api.mvc.Results import play.api.routing.Router import play.api.routing.sird._ lazy val router: Router = Router.from({ case GET(p"/") => defaultActionBuilder { Results.Ok("success!") } }) override lazy val configuration: Configuration = Configuration("foo" -> "bar", "ehcacheplugin" -> "disabled").withFallback(context.initialConfiguration) } "The OneServerPerSuiteWithComponents trait" must { "provide an Application" in { import play.api.test.Helpers.{GET, route} val Some(result: Future[Result]) = route(app, FakeRequest(GET, "/")) Helpers.contentAsString(result) must be("success!") } "override the configuration" in { app.configuration.getOptional[String]("foo") mustBe Some("bar") } } }
If you have many tests that can share the same Application
, 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 OneAppPerSuiteWithComponents
and declares the nested
Suite
s. Annotate the nested suites with @DoNotDiscover
and have them extend ConfiguredApp
. Here's an example:
import org.scalatest.{DoNotDiscover, Suites, TestSuite} import org.scalatestplus.play.components.OneAppPerSuiteWithComponents import org.scalatestplus.play.{ConfiguredApp, PlaySpec} import play.api._ import play.api.mvc.Result import play.api.test.Helpers._ import play.api.test.{FakeRequest, Helpers} import scala.concurrent.Future class NestedExampleSpec extends Suites( new OneSpec, new TwoSpec, new RedSpec, new BlueSpec ) with OneAppPerSuiteWithComponents with TestSuite { // Override fakeApplication if you need an Application with other than non-default parameters. override def components: BuiltInComponents = new BuiltInComponentsFromContext(context) with NoHttpFiltersComponents { import play.api.mvc.Results import play.api.routing.Router import play.api.routing.sird._ lazy val router: Router = Router.from({ case GET(p"/") => defaultActionBuilder { Results.Ok("success!") } }) override lazy val configuration: Configuration = Configuration("ehcacheplugin" -> "disabled").withFallback(context.initialConfiguration) } } // These are the nested suites @DoNotDiscover class OneSpec extends PlaySpec with ConfiguredApp { "OneSpec" must { "make the Application available implicitly" in { def getConfig(key: String)(implicit app: Application) = app.configuration.getOptional[String](key) getConfig("ehcacheplugin") mustBe Some("disabled") } } } @DoNotDiscover class TwoSpec extends PlaySpec with ConfiguredApp @DoNotDiscover class RedSpec extends PlaySpec with ConfiguredApp @DoNotDiscover class BlueSpec extends PlaySpec with ConfiguredApp { "The NestedExampleSpec" must { "provide an Application" in { import play.api.test.Helpers.{ GET, route } val Some(result: Future[Result]) = route(app, FakeRequest(GET, "/")) Helpers.contentAsString(result) must be("success!") } } }
- Self Type
- OneAppPerSuiteWithComponents with TestSuite
- Source
- OneAppPerSuiteWithComponents.scala
- Alphabetic
- By Inheritance
- OneAppPerSuiteWithComponents
- FakeApplicationFactory
- WithApplicationComponents
- BaseOneAppPerSuite
- TestSuiteMixin
- SuiteMixin
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Abstract Value Members
- abstract def components: BuiltInComponents
Override this function to instantiate the components - a factory of sorts.
Override this function to instantiate the components - a factory of sorts.
- returns
the components to be used by the application
- Definition Classes
- WithApplicationComponents
- 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: (OneAppPerSuiteWithComponents.this)#NoArgTest): Outcome
- Attributes
- protected
- Definition Classes
- TestSuiteMixin
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- implicit lazy val app: Application
An implicit instance of
Application
.An implicit instance of
Application
.- Definition Classes
- BaseOneAppPerSuite
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native()
- def context: Context
- returns
a context to use to create the application.
- Definition Classes
- WithApplicationComponents
- final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef → Any
- def fakeApplication(): Application
- Definition Classes
- OneAppPerSuiteWithComponents → FakeApplicationFactory
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable])
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- def hashCode(): Int
- Definition Classes
- AnyRef → Any
- Annotations
- @native()
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def newApplication: Application
- returns
new application instance and set the components. This must be called for components to be properly set up.
- Definition Classes
- WithApplicationComponents
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native()
- def run(testName: Option[String], args: Args): Status
Invokes
Play.start
, passing in theApplication
provided byapp
, and places that sameApplication
into theConfigMap
under the keyorg.scalatestplus.play.app
to make it available to nested suites; callssuper.run
; and lastly ensuresPlay.stop
is invoked after all tests and nested suites have completed.Invokes
Play.start
, passing in theApplication
provided byapp
, and places that sameApplication
into theConfigMap
under the keyorg.scalatestplus.play.app
to make it available to nested suites; callssuper.run
; and lastly ensuresPlay.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 thisSuite
.- 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
- BaseOneAppPerSuite → 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(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()