kotest-extensions-testcontainers

Kotest extensions for TestContainers.

See docs.

Please create issues on the main kotest board.

Compatibility

Starting with version 1.3.4, the minimum Java version is 11.

Changelog

3.0.0

• Deleted all deprecations
• Container is now receiver of beforeStart, afterStart, beforeShutdown and afterShutdown lifecycle hooks`
• Bumped Gradle to 8.8

2.0.0

• Deprecated older extensions and introduced JdbcDatabaseContainerExtension and ContainerExtension extensions
• Deprecated Kafka extensions in favour of the kotest-extensions-testcontainers-kafka module
• Added kafka container .producer(), .consumer() and .admin() extension methods for opening producers, consumers and admin clients.
• Added DockerComposeContainerExtension for executing test containers from docker compose files.
• Added kotest-extensions-testcontainers-elastic and kotest-extensions-testcontainers-localstack
• Deprecated per-test lifecycle modes
• Deprecated custom SQL runner in favour of Flyway or another widely used db migration framework.

1.3.4

• 5.4.0 compatibility

1.3.3

• Version updates

1.3.2

• Updated spec and test callbacks to be suspendable.

1.3.1

• Updated test containers to 1.17.0

1.3.0

• Added SharedJdbcDatabaseContainerExtension and SharedTestContainerExtension which can be used to lazily share a single test container across a module.

1.2.1

• Improves the handling of dbInitScripts. Will now accept absolute or relative paths, for local or classpath resources.

1.2.0

• Adds new config option dbInitScripts on the JdbcTestContainerExtension config lambda. This option accepts a list of .sql files or folders (with .sql files, sorted lexicographically) to run after the container is started.

1.1.0

• Requires Kotest 5.0.2 or higher
• Adds JdbcTestContainerExtension as a new extension
• Adds TestContainerExtension as a new extension

1.0.1

• Released for test containers v1.16.0

1.0.0

• Migrated from the main Kotest repo to a standalone repo.