An implicit instance of Application
.
An implicit instance of Application
.
The port used by the TestServer
.
The port used by the TestServer
. By default this will be set to the result returned from
Helpers.testServerPort
. You can override this to provide a different 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
Invokes start
on a new TestServer
created with the Application
provided by app
and the
port number defined by port
, places the Application
and port number into the ConfigMap
under the keys
org.scalatestplus.play.app
and org.scalatestplus.play.port
, respectively, to make
them available to nested suites; calls super.run
; and lastly ensures the Application
and test server are stopped after
all tests and nested suites have completed.
Invokes start
on a new TestServer
created with the Application
provided by app
and the
port number defined by port
, places the Application
and port number into the ConfigMap
under the keys
org.scalatestplus.play.app
and org.scalatestplus.play.port
, respectively, to make
them available to nested suites; calls super.run
; and lastly ensures the Application
and test server are stopped after
all tests and nested suites have completed.
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.
Trait that provides a new
Application
and runningTestServer
instance per ScalaTestSuite
.By default, this trait creates a new
Application
for theSuite
using default parameter values, which is made available via theapp
field defined in this trait and a newTestServer
for theSuite
using the port number provided by itsport
field and theApplication
provided by itsapp
field. If yourSuite
needs aApplication
with non-default parameters, overrideapp
. If it needs a different port number, overrideport
.This
TestSuiteMixin
trait's overriddenrun
method callsstart
on theTestServer
before executing theSuite
via a call tosuper.run
. In addition, it places a reference to theApplication
provided byapp
into theConfigMap
under the keyorg.scalatestplus.play.app
and to the port number provided byport
under the keyorg.scalatestplus.play.port
. This allows any nestedSuite
s to access theSuite
'sApplication
and port number as well, most easily by having the nestedSuite
s mix in the ConfiguredServer trait. On the status returned bysuper.run
, this trait's overriddenrun
method registers a call tostop
on theTestServer
to be executed when theStatus
completes, and returns the sameStatus
. This ensure theTestServer
will continue to execute until all nested suites have completed, after which theTestServer
will be stopped.Here's an example that demonstrates some of the services provided by this trait:
If you have many tests that can share the same
Application
andTestServer
, and you don't want to put them all into one test class, you can place them into differentSuite
classes. These will be your nested suites. Create a master suite that extendsOneServerPerSuite
and declares the nestedSuite
s. Annotate the nested suites with@DoNotDiscover
and have them extendConfiguredServer
. Here's an example: