Trait

com.dimafeng.testcontainers.munit

TestContainersForEach

Related Doc: package munit

Permalink

trait TestContainersForEach extends TestContainersSuite

Starts containers before each test and stop them after each test

Example:

class ExampleSpec extends FunSuite with TestContainersForEach {

  // First of all, you need to declare, which containers you want to use
  override type Containers = MySQLContainer and PostgreSQLContainer

  // After that, you need to describe, how you want to start them,
  // In this method you can use any intermediate logic.
  // You can pass parameters between containers, for example.
  override def startContainers(): Containers = {
    val container1 = MySQLContainer.Def().start()
    val container2 = PostgreSQLContainer.Def().start()
    container1 and container2
  }

  // `withContainers` function supports multiple containers:
  test("test") {
    withContainers { case mysqlContainer and pgContainer =>
      // Inside your test body you can do with your containers whatever you want to
      assert(mysqlContainer.jdbcUrl.nonEmpty && pgContainer.jdbcUrl.nonEmpty)
    }
  }
}

Notes:
- If you override beforeEach() without calling super.beforeEach() your containers won't start
- If you override afterEach() without calling super.afterEach() your containers won't stop
Self Type
TestContainersForEach with Suite
Linear Supertypes
TestContainersSuite, DockerImageNameConverters, AnyRef, Any
Known Subclasses
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TestContainersForEach
  2. TestContainersSuite
  3. DockerImageNameConverters
  4. AnyRef
  5. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. abstract type Containers <: Andable

    Permalink

    To use testcontainers suites you need to declare, which containers you want to use inside your tests.

    To use testcontainers suites you need to declare, which containers you want to use inside your tests.

    For example:

    override type Containers = MySQLContainer

    If you want to use multiple containers inside your tests, use and syntax:

    override type Containers = MySQLContainer and PostgreSQLContainer
    Definition Classes
    TestContainersForEachTestContainersSuite

Abstract Value Members

  1. abstract def startContainers(): (TestContainersForEach.this)#Containers

    Permalink

    Contains containers startup logic.

    Contains containers startup logic. In this method you can use any intermediate logic. You can pass parameters between containers, for example:

    override def startContainers(): Containers = {
      val container1 = Container1.Def().start()
      val container2 = Container2.Def(container1.someParam).start()
      container1 and container2
    }
    returns

    Started containers

    Definition Classes
    TestContainersSuite

Concrete Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

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

    Permalink
    Definition Classes
    AnyRef → Any
  4. def afterContainersStart(containers: (TestContainersForEach.this)#Containers): Unit

    Permalink

    Override, if you want to do something after containers start.

    Override, if you want to do something after containers start.

    Definition Classes
    TestContainersSuite
  5. def afterEach(context: (TestContainersForEach.this)#AfterEach): Unit

    Permalink
  6. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  7. def beforeContainersStop(containers: (TestContainersForEach.this)#Containers): Unit

    Permalink

    Override, if you want to do something before containers stop.

    Override, if you want to do something before containers stop.

    Definition Classes
    TestContainersSuite
  8. def beforeEach(context: (TestContainersForEach.this)#BeforeEach): Unit

    Permalink
  9. def clone(): AnyRef

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

    Permalink
    Definition Classes
    AnyRef
  11. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  12. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate()
  13. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
    Annotations
    @HotSpotIntrinsicCandidate()
  14. final def isInstanceOf[T0]: Boolean

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

    Permalink
    Definition Classes
    AnyRef
  16. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate()
  17. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @HotSpotIntrinsicCandidate()
  18. val suiteDescription: TestDescription

    Permalink
    Definition Classes
    TestContainersSuite
  19. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  20. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  21. final def wait(arg0: Long, arg1: Int): Unit

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

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  23. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  24. def withContainers[A](runTest: ((TestContainersForEach.this)#Containers) ⇒ A): A

    Permalink

    To use containers inside your test bodies you need to use withContainers function:

    To use containers inside your test bodies you need to use withContainers function:

    test("test") {
      withContainers { mysqlContainer =>
        // Inside your test body you can do with your container whatever you want to
        assert(mysqlContainer.jdbcUrl.nonEmpty)
      }
    }

    withContainers also supports multiple containers:

    test("test") {
      withContainers { case mysqlContainer and pgContainer =>
        // test body
      }
    }
    runTest

    Test body

    Definition Classes
    TestContainersSuite

Deprecated Value Members

  1. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @Deprecated @deprecated @throws( classOf[java.lang.Throwable] )
    Deprecated

    (Since version ) see corresponding Javadoc for more information.

  2. implicit def stringToDockerImageName(s: String): DockerImageName

    Permalink
    Definition Classes
    DockerImageNameConverters
    Annotations
    @deprecated
    Deprecated

    Use DockerImageName in Container constructor instead

Inherited from TestContainersSuite

Inherited from DockerImageNameConverters

Inherited from AnyRef

Inherited from Any

Ungrouped