Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions AI.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,15 @@ This is a **Go monorepo** containing:
## Environment Setup

### Go Version
- **Required**: Go 1.25.7
- **Required**: Go 1.25.9
- **Tool**: Use [gvm](https://github.com/andrewkroh/gvm) for version management
- **CRITICAL**: Always run this before ANY Go command:
```bash
# For Apple Silicon (M1/M2/M3)
eval "$(gvm 1.25.7 --arch=arm64)"
eval "$(gvm 1.25.9 --arch=arm64)"

# For Intel/AMD (x86_64)
eval "$(gvm 1.25.7 --arch=amd64)"
eval "$(gvm 1.25.9 --arch=amd64)"
```

### Project Structure
Expand Down Expand Up @@ -171,14 +171,14 @@ func Run(ctx context.Context, img string, opts ...testcontainers.ContainerCustom
### When Tests Fail
1. **Read the error message carefully** - it usually tells you exactly what's wrong
2. **Check if it's a lint issue** - run `make pre-commit` first
3. **Verify Go version** - ensure using Go 1.25.7
3. **Verify Go version** - ensure using Go 1.25.9
4. **Check Docker** - some tests require Docker daemon running

## Common Pitfalls to Avoid

### Code Issues
- ❌ Using interface types as return values
- ❌ Forgetting to run `eval "$(gvm 1.25.7 --arch=arm64)"`
- ❌ Forgetting to run `eval "$(gvm 1.25.9 --arch=arm64)"`
- ❌ Not handling errors from built-in options
- ❌ Using module-specific container names (`PostgresContainer`)
- ❌ Calling `.Customize()` method instead of direct function call
Expand Down
2 changes: 1 addition & 1 deletion docs/system_requirements/ci/circle_ci.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ workflows:
- tests:
matrix:
parameters:
go-version: ["1.25.7", "1.26.1"]
go-version: ["1.25.9", "1.26.2"]

```

Expand Down
2 changes: 1 addition & 1 deletion examples/nginx/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/examples/nginx

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
dario.cat/mergo v1.0.2
Expand Down
2 changes: 1 addition & 1 deletion modulegen/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modulegen

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/spf13/cobra v1.10.2
Expand Down
2 changes: 1 addition & 1 deletion modules/aerospike/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/aerospike

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/aerospike/aerospike-client-go/v8 v8.6.0
Expand Down
2 changes: 1 addition & 1 deletion modules/arangodb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/arangodb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/arangodb/go-driver/v2 v2.1.3
Expand Down
2 changes: 1 addition & 1 deletion modules/artemis/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/artemis

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/go-stomp/stomp/v3 v3.0.5
Expand Down
2 changes: 1 addition & 1 deletion modules/azure/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/azure

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/Azure/azure-sdk-for-go/sdk/azcore v1.21.0
Expand Down
2 changes: 1 addition & 1 deletion modules/azure/lowkeyvault/testdata/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module lowkeyvault_network_test

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/Azure/azure-sdk-for-go/sdk/azcore v1.21.0
Expand Down
2 changes: 1 addition & 1 deletion modules/azurite/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/azurite

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
2 changes: 1 addition & 1 deletion modules/cassandra/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/cassandra

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/gocql/gocql v1.6.0
Expand Down
2 changes: 1 addition & 1 deletion modules/chroma/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/chroma

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/amikos-tech/chroma-go v0.3.2
Expand Down
2 changes: 1 addition & 1 deletion modules/clickhouse/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/clickhouse

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/ClickHouse/clickhouse-go/v2 v2.34.0
Expand Down
2 changes: 1 addition & 1 deletion modules/cockroachdb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/cockroachdb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/jackc/pgx/v5 v5.5.4
Expand Down
2 changes: 1 addition & 1 deletion modules/consul/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/consul

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/hashicorp/consul/api v1.27.0
Expand Down
2 changes: 1 addition & 1 deletion modules/couchbase/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/couchbase

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/cenkalti/backoff/v4 v4.3.0
Expand Down
2 changes: 1 addition & 1 deletion modules/databend/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/databend

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/datafuselabs/databend-go v0.7.0
Expand Down
2 changes: 1 addition & 1 deletion modules/dind/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/dind

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/moby/moby/api v1.54.1
Expand Down
2 changes: 1 addition & 1 deletion modules/dockermcpgateway/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/dockermcpgateway

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/moby/moby/api v1.54.1
Expand Down
2 changes: 1 addition & 1 deletion modules/dockermodelrunner/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/dockermodelrunner

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/moby/moby/client v0.4.0
Expand Down
2 changes: 1 addition & 1 deletion modules/dolt/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/dolt

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/go-sql-driver/mysql v1.7.1
Expand Down
2 changes: 1 addition & 1 deletion modules/dynamodb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/dynamodb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/aws/aws-sdk-go-v2 v1.31.0
Expand Down
2 changes: 1 addition & 1 deletion modules/elasticsearch/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/elasticsearch

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/elastic/go-elasticsearch/v8 v8.12.1
Expand Down
2 changes: 1 addition & 1 deletion modules/etcd/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/etcd

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/containerd/errdefs v1.0.0
Expand Down
2 changes: 1 addition & 1 deletion modules/forgejo/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/forgejo

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
2 changes: 1 addition & 1 deletion modules/gcloud/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/gcloud

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
cloud.google.com/go/bigquery v1.59.1
Expand Down
2 changes: 1 addition & 1 deletion modules/grafana-lgtm/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/grafana-lgtm

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
2 changes: 1 addition & 1 deletion modules/inbucket/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/inbucket

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/inbucket/inbucket v2.0.0+incompatible
Expand Down
2 changes: 1 addition & 1 deletion modules/influxdb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/influxdb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/influxdata/influxdb-client-go/v2 v2.14.0
Expand Down
2 changes: 1 addition & 1 deletion modules/k3s/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/k3s

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/moby/moby/api v1.54.1
Expand Down
2 changes: 1 addition & 1 deletion modules/k6/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/k6

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/moby/moby/api v1.54.1
Expand Down
2 changes: 1 addition & 1 deletion modules/kafka/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/kafka

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/IBM/sarama v1.42.1
Expand Down
2 changes: 1 addition & 1 deletion modules/localstack/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/localstack

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/aws/aws-sdk-go v1.50.31
Expand Down
2 changes: 1 addition & 1 deletion modules/mariadb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/mariadb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/go-sql-driver/mysql v1.7.1
Expand Down
2 changes: 1 addition & 1 deletion modules/meilisearch/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/meilisearch

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
2 changes: 1 addition & 1 deletion modules/memcached/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/memcached

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/bradfitz/gomemcache v0.0.0-20250403215159-8d39553ac7cf
Expand Down
2 changes: 1 addition & 1 deletion modules/milvus/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/milvus

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/milvus-io/milvus/client/v2 v2.6.0
Expand Down
2 changes: 1 addition & 1 deletion modules/minio/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/minio

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/minio/minio-go/v7 v7.0.68
Expand Down
2 changes: 1 addition & 1 deletion modules/mockserver/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/mockserver

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/BraspagDevelopers/mock-server-client v0.2.2
Expand Down
2 changes: 1 addition & 1 deletion modules/mongodb/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ module github.com/testcontainers/testcontainers-go/modules/mongodb

go 1.25.0

toolchain go1.25.7
toolchain go1.25.9

require (
github.com/stretchr/testify v1.11.1
Expand Down
Loading
Loading