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.

Extension version	Min. Java version
1.3.3	8
1.3.4	11
2.0.0	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.