Extract core/v2 (collapse tier-0 utils into modules/core) (#1858)

* extract core/v2: collapse tier-0 utils into a modules/core submodule

First tier of the v2 modularization. Moves logger, testing, retry, random, files, shell and the internal collections/formatting helpers into a new modules/core module (github.com/gruntwork-io/terratest/modules/core/v2), rewriting all imports to their /v2 paths. Adds a root go.work plus a replace so the umbrella module resolves core locally and under GOWORK=off. Core's go.mod is seeded to the root's dependency versions so nothing floats; the other domains, cmd/, and the CI tooling are untouched.

* document the go.work and root replace resolution model

Author: james00012

cmd/terratest_log_parser/main.go

@@ -42,7 +42,7 @@ import (
 	"github.com/gruntwork-io/go-commons/entrypoint"
 	"github.com/gruntwork-io/go-commons/errors"
 	"github.com/gruntwork-io/go-commons/logging"
-	"github.com/gruntwork-io/terratest/modules/logger/parser"
+	"github.com/gruntwork-io/terratest/modules/core/v2/logger/parser"
 	"github.com/sirupsen/logrus"
 	"github.com/urfave/cli"
 )

go.mod

@@ -16,7 +16,7 @@ require (
 	github.com/hashicorp/hcl/v2 v2.22.0
 	github.com/hashicorp/terraform-json v0.23.0
 	github.com/jinzhu/copier v0.0.0-20190924061706-b57f9002281a
-	github.com/jstemmer/go-junit-report v1.0.0
+	github.com/jstemmer/go-junit-report v1.0.0 // indirect
 	github.com/magiconair/properties v1.8.7
 	github.com/mattn/go-zglob v0.0.2-0.20190814121620-e3c945676326
 	github.com/miekg/dns v1.1.62
@@ -94,6 +94,7 @@ require (
 	github.com/aws/aws-sdk-go-v2/service/sts v1.42.0
 	github.com/aws/smithy-go v1.27.1
 	github.com/gonvenience/ytbx v1.4.4
+	github.com/gruntwork-io/terratest/modules/core/v2 v2.0.0-00010101000000-000000000000
 	github.com/hashicorp/go-getter/v2 v2.2.3
 	github.com/homeport/dyff v1.6.0
 	github.com/jackc/pgx/v5 v5.9.0
@@ -243,3 +244,11 @@ require (
 	sigs.k8s.io/structured-merge-diff/v6 v6.3.2 // indirect
 	sigs.k8s.io/yaml v1.6.0 // indirect
 )
+
+// The root module (examples/ and test/) imports core/v2, which is not published
+// yet. go.work resolves it for workspace builds, but `go mod tidy` (the CI tidy
+// check) and any GOWORK=off build ignore go.work, so this replace is what lets
+// them find core locally. Dev-only: the root module is not published in v2
+// (consumers import the submodules directly), and this replace is never part of
+// a release tag. As more tiers split out, the root gains one replace per submodule.
+replace github.com/gruntwork-io/terratest/modules/core/v2 => ./modules/core

go.work

@@ -0,0 +1,14 @@
+go 1.26.0
+
+// Development workspace. Resolves the local /v2 submodules for `go build` and
+// `go test` so they see each other's uncommitted code without publishing anything
+// or adding per-module `replace` directives, which keeps the submodule go.mod
+// files clean. As more tiers split out, each adds a `use ./modules/<name>` line.
+//
+// Not used at release: tags are cut with GOWORK=off and no replaces, and the
+// published modules resolve each other by version from the proxy. See
+// scripts/check-release-mode.sh, which validates that GOWORK=off build.
+use (
+	.
+	./modules/core
+)

go.work.sum

@@ -0,0 +1,3 @@
+cloud.google.com/go/compute v1.54.0 h1:4CKmnpO+40z44bKG5bdcKxQ7ocNpRtOc9SCLLUzze1w=
+cloud.google.com/go/pubsub v1.50.1 h1:fzbXpPyJnSGvWXF1jabhQeXyxdbCIkXTpjXHy7xviBM=
+github.com/russross/blackfriday v1.6.0 h1:KqfZb0pUVN2lYqZUYRddxF4OR8ZMURnJIG5Y3VRLtww=

modules/aws/account.go

@@ -9,7 +9,7 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/sts"
 	"github.com/stretchr/testify/require"
 
-	"github.com/gruntwork-io/terratest/modules/testing"
+	"github.com/gruntwork-io/terratest/modules/core/v2/testing"
 )
 
 // minARNParts is the minimum number of colon-separated parts in a valid IAM ARN.

modules/aws/acm.go

@@ -6,7 +6,7 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/acm"
 	"github.com/stretchr/testify/require"
 
-	"github.com/gruntwork-io/terratest/modules/testing"
+	"github.com/gruntwork-io/terratest/modules/core/v2/testing"
 )
 
 // AcmAPI is the subset of *acm.Client operations used by the helpers in this file.

modules/aws/ami.go

@@ -9,8 +9,8 @@ import (
 	"github.com/aws/aws-sdk-go-v2/aws"
 	"github.com/aws/aws-sdk-go-v2/service/ec2"
 	"github.com/aws/aws-sdk-go-v2/service/ec2/types"
-	"github.com/gruntwork-io/terratest/modules/logger"
-	"github.com/gruntwork-io/terratest/modules/testing"
+	"github.com/gruntwork-io/terratest/modules/core/v2/logger"
+	"github.com/gruntwork-io/terratest/modules/core/v2/testing"
 	"github.com/stretchr/testify/require"
 )
 

modules/aws/asg.go

@@ -9,9 +9,9 @@ import (
 	"github.com/aws/aws-sdk-go-v2/service/autoscaling"
 	"github.com/stretchr/testify/require"
 
-	"github.com/gruntwork-io/terratest/modules/logger"
-	"github.com/gruntwork-io/terratest/modules/retry"
-	"github.com/gruntwork-io/terratest/modules/testing"
+	"github.com/gruntwork-io/terratest/modules/core/v2/logger"
+	"github.com/gruntwork-io/terratest/modules/core/v2/retry"
+	"github.com/gruntwork-io/terratest/modules/core/v2/testing"
 )
 
 // AsgCapacityInfo holds capacity information about an Auto Scaling Group.

modules/aws/asg_test.go

@@ -14,7 +14,7 @@ import (
 	"github.com/stretchr/testify/require"
 
 	aws "github.com/gruntwork-io/terratest/modules/aws"
-	"github.com/gruntwork-io/terratest/modules/random"
+	"github.com/gruntwork-io/terratest/modules/core/v2/random"
 )
 
 func TestGetCapacityInfoForAsg(t *testing.T) {

modules/aws/cloudwatch.go

@@ -5,7 +5,7 @@ import (
 
 	"github.com/aws/aws-sdk-go-v2/aws"
 	"github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs"
-	"github.com/gruntwork-io/terratest/modules/testing"
+	"github.com/gruntwork-io/terratest/modules/core/v2/testing"
 	"github.com/stretchr/testify/require"
 )