Environment

The execution of a Specification depends on various parts, among which:

All of this is bundled into one object org.specs2.specification.core.Env. The Env is accessible to your Specification by either:

Dependency injection

The following objects can be injected in your specification if you declare a 1-parameter constructor:

For example:

class MySpec(env: Env) extends Specification { def is = s2"""
  Use the environment fileSystem
  ${ env.fileSystem.mkdirs("tmp" / "test").runOption; ok }
"""
}

Or if you want to access an ExecutionContext:

class MySpec(implicit ec: ExecutionContext) extends Specification { def is = s2"""
  Use a future
  ${ Await.result(Future(1), 1.seconds) must_== 1 }
"""
  }

Own Env / ExecutionEnvironment

The ExecutionEnv which is injected in a specification will be shared with all specifications. If you want to provide some isolation between your specifications and get a specific thread pool being dedicated to your specification you use the org.specs2.specification.core.OwnEnv or org.specs2.specification.core.OwnExecutionEnv traits:

class MySpec(val env: Env) extends Specification with OwnExecutionEnv { def is = s2"""
  Use a future
  ${ Await.result(Future(1), 1.seconds) must_== 1 }
"""
  }

You need to inject a public env which will be duplicated to create an implicit ExecutionEnv for the sole use of your specification (and shutdown when your specification has been executed). Doing so ensures that command line arguments influencing the execution of your specification, like threadsnb or timefactor will be used.

And if you want to know more