github.com/testcontainers/testcontainers-go breaking changes

v0.43.0

1 breaking change, first published June 19, 2026.

• Signature changed github.com/testcontainers/testcontainers-go/wait.ForSQL
  The url callback passed to wait.ForSQL now takes a network.Port rather than a string port. Callbacks that need the string form must call port.String(), or use port.Port() or port.Proto(). pkg.go.dev

v0.42.0

33 breaking changes, first published April 9, 2026.

• Signature changed github.com/testcontainers/testcontainers-go.Container.MappedPort
  Was func MappedPort(context.Context, nat.Port) (nat.Port, error); now func MappedPort(context.Context, string) (network.Port, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.Container.PortEndpoint
  Was func PortEndpoint(context.Context, nat.Port, string) (string, error); now func PortEndpoint(context.Context, string, string) (string, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.Container.Ports
  Was func Ports(context.Context) (nat.PortMap, error); now func Ports(context.Context) (network.PortMap, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.ContainerRequest.BuildOptions
  Was func BuildOptions() (build.ImageBuildOptions, error); now func BuildOptions() (client.ImageBuildOptions, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.ContainerRequest.BuildOptionsModifier
  Was BuildOptionsModifier func(*build.ImageBuildOptions); now BuildOptionsModifier func(*client.ImageBuildOptions). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.DeprecatedContainer.LivenessCheckPorts
  Was func LivenessCheckPorts(context.Context) (nat.PortSet, error); now func LivenessCheckPorts(context.Context) (network.PortSet, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.DockerClient.DiskUsage
  Was func DiskUsage(context.Context, types.DiskUsageOptions) (types.DiskUsage, error); now func DiskUsage(context.Context, client.DiskUsageOptions) (client.DiskUsageResult, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.DockerClient.Events
  Was func Events(context.Context, events.ListOptions) (<-chan events.Message, <-chan error); now func Events(context.Context, client.EventsListOptions) client.EventsResult. pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.DockerClient.Info
  Was func Info(context.Context) (system.Info, error); now func Info(context.Context, client.InfoOptions) (client.SystemInfoResult, error). pkg.go.dev
• Signature changed github.com/testcontainers/testcontainers-go.DockerClient.Ping
  Was func Ping(context.Context) (types.Ping, error); now func Ping(context.Context, client.PingOptions) (client.PingResult, error). pkg.go.dev

And 23 more in this version.

Check your code

These are the changes. To see which of them reach your code, scan a public repository, or have your coding agent call check_code with your manifest or lockfile over MCP. The API reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.