Download Latest Version v0.38.0 source code.zip (21.4 MB)
Email in envelope

Get an email when there's a new version of Testcontainers Go

Home / v0.38.0
Name Modified Size InfoDownloads / Week
Parent folder
README.md 2025-07-15 5.8 kB
v0.38.0 source code.tar.gz 2025-07-15 20.9 MB
v0.38.0 source code.zip 2025-07-15 21.4 MB
Totals: 3 Items   42.3 MB 2

What's Changed

⚠️ Breaking Changes

  • chore!: do not wait for all the exposed ports to be ready (#3199) @mdelapenya

The breaking change comes as a behaviour that has been removed: the readiness check for the exposed ports. It led to flakiness and for that reason we removed it.

  • feat!: add options when creating RawCommand (#3168) @benja-M-1

Only for users of the testcontainers.NewRawCommand function to create executables in containers, that are assigning the function to a variable. We added a variadic argument to the signature, so the rest of the users won't be affected by this breaking change.

Implementers of the testcontainers.ImageBuildInfo interface, would see that testcontainers.BuildOptions has changed its signature to use non-deprecated types from docker/docker:

:::diff
type ImageBuildInfo interface {
-    BuildOptions() (types.ImageBuildOptions, error) // converts the ImageBuildInfo to a types.ImageBuildOptions
+        BuildOptions() (build.ImageBuildOptions, error) // converts the ImageBuildInfo to a build.ImageBuildOptions

Also users of the testcontainers.FromDockerfile struct will receive this breaking change, as the BuildOptionsModifier fields has changed:

:::diff
- BuildOptionsModifier func(*types.ImageBuildOptions)
+ BuildOptionsModifier func(*build.ImageBuildOptions)

🔒 Security

  • deps: update testcontainers/sshd image to 1.3.0 (#3220) @mdelapenya

🚀 Features

  • feat(couchbase): adding auth to couchbase initCluster functions to support container reuse (#3048) @waroir20
  • feat: support adding wait strategies as functional option (#3161) @mdelapenya
  • feat: add more functional options for customising containers (#3156) @mdelapenya
  • feat(memcached): add memcached module (#3132) @mdelapenya
  • feat(valkey): add TLS support for Valkey (#3131) @mdelapenya

🐛 Bug Fixes

  • fix: strip headers from logs using log stream specification (#3226) @LaurentGoderre
  • fix: use PortEndpoint() in a few more modules (#3209) @ash2k
  • fix: docker container log consumer race (#3210) @stevenh
  • fix: use PortEndpoint() in a few more modules (#3207) @ash2k
  • fix: use PortEndpoint() in a few more modules (#3206) @ash2k
  • fix: use PortEndpoint() in a few more modules (#3203) @ash2k
  • fix: try to fix more IPv6 handling issues (#3198) @ash2k
  • fix: workaround for moby/moby#50133 when reusing container (#3197) @mabrarov
  • feat(kafka,redpanda): support for waiting for mapped ports without external checks (#3165) @mabrarov
  • fix(etcd): expose ports for the etcd nodes (#3162) @mdelapenya
  • fix(wait): no port to wait for (#3158) @stevenh
  • fix(etcd): single node etcd cluster access (#3149) @3vilhamster
  • fix(dockermodelrunner): wait for the model to be pulled (#3125) @mdelapenya
  • fix(localstack): remove checksum from image name before parsing version (#3130) @trallnag

📖 Documentation

  • docs: document copy from container (#3215) @mdelapenya
  • docs(options): refactor options layout in modules (#3163) @mdelapenya
  • docs(redpanda): update sasl authentication option to use scram sha 256 (#3126) @peczenyj

🧹 Housekeeping

  • chore: clarify image auth warning message for public images (#3228) @diegolatorre16
  • chore(deps): bump github.com/go-viper/mapstructure/v2 from 2.0.0 to 2.3.0 in /modules/compose (#3219) @dependabot[bot]
  • chore(deps): bump github/codeql-action from 3.28.16 to 3.29.2 (#3222) @dependabot[bot]
  • chore(deps): bump mkdocs-include-markdown-plugin from 7.1.5 to 7.1.6 (#3225) @dependabot[bot]
  • chore(exec): remove uses of ExecOptions.Detach (#3211) @thaJeztah
  • chore(format): fix suggestions detected by gopls modernize (#3208) @peczenyj
  • chore(deps): bump github.com/containerd/containerd/v2 from 2.0.4 to 2.0.5 in /modules/compose (#3167) @dependabot[bot]
  • fix(ci): do not run sonar for Testcontainers Cloud (#3166) @mdelapenya
  • chore(ci): do not fail fast in the Testcontainers Cloud run (#3164) @mdelapenya

📦 Dependency updates

Source: README.md, updated 2025-07-15