ConfiguredServer
The "configured" FakeApplication instance that was passed into run via the ConfigMap.
The "configured" FakeApplication instance that was passed into run via the ConfigMap.
the configured FakeApplication
The "configured" port number, passed into run via the ConfigMap, at which the TestServer is running.
The "configured" port number, passed into run via the ConfigMap, at which the TestServer is running.
the configured port number
Implicit PortNumber instance that wraps port.
Implicit PortNumber instance that wraps port. The value returned from portNumber.value
will be same as the value of port.
the configured port number, wrapped in a PortNumber
Looks in args.configMap for a key named "org.
Looks in args.configMap for a key named "org.scalatestplus.play.app" whose value is a FakeApplication,
and a key named "org.scalatestplus.play.port" whose value is an Int,
and if they exist, sets the FakeApplication as the value that will be returned from the app method and
the Int as the value that will be returned from the port method, then calls
super.run.
If no key matches "org.scalatestplus.play.app" in args.configMap, or the associated value is
not a FakeApplication, or if no key matches "org.scalatestplus.play.port" in args.configMap,
or the associated value is not an Int, throws IllegalArgumentException.
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.
the Args for this run
a Status object that indicates when all tests and nested suites started by this method have completed, and whether or not a failure occurred.
if the FakeApplication and/or port number does not appear in args.configMap under the expected keys
Trait that provides a configured
FakeApplicationand server port number to the suite into which it is mixed.The purpose of this trait is to allow nested suites of an enclosing suite that extends OneServerPerSuite to make use of the
FakeApplicationand port number provided byOneServerPerSuite. TraitOneServerPerSuitewill ensure theFakeApplicationis placed in theConfigMapunder the keyorg.scalatestplus.play.appand the port number under the keyorg.scalatestplus.play.portbefore nested suites are invoked. This information represents the "configured server" that is passed from the enclosing suite to the nested suites. TraitConfiguredServerextracts this information from from theConfigMapand makes theFakeApplicationavailable via theappmethod, the port number available as anIntfrom theportmethod, and also the port number wrapped in a PortNumber available as implicit methodportNumber(for use with trait WsScalaTestClient).To prevent discovery of nested suites you can annotate them with
@DoNotDiscover. Here's an example, taken fromOneAppPerSuite's documentation:package org.scalatestplus.play.examples.oneserverpersuite 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 OneServerPerSuite { // 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 ConfiguredServer @DoNotDiscover class TwoSpec extends PlaySpec with ConfiguredServer @DoNotDiscover class RedSpec extends PlaySpec with ConfiguredServer @DoNotDiscover class BlueSpec extends PlaySpec with ConfiguredServer { "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) } "provide the port number" in { port mustBe Helpers.testServerPort } "provide an actual running server" in { import Helpers._ import java.net._ val url = new URL("http://localhost:" + port + "/boum") val con = url.openConnection().asInstanceOf[HttpURLConnection] try con.getResponseCode mustBe 404 finally con.disconnect() } } }