Starting v3 release for plugin developers.

[doc]: https://github.com/golang/go/wiki/Modules#releasing-modules-v2-or-higher

Per this Go modules [doc] a repo or branch that's
already tagged v2 or higher should increment the major
version (e.g. go to v3) when releasing their first Go
module-based packages.

At the moment, the kustomize repo has these top level
packages in the sigs.k8s.io/kustomize module:

 - `cmd` - holds main program for kustomize

	 Conceivably someone can depend on this
	 package for integration tests.

 - `internal` - intentionally unreleased subpackages

 - `k8sdeps` - an adapter wrapping k8s dependencies

	 This exists only for use in pre-Go-modules kustomize-into-kubectl
	 integration and won't live much longer (as everything involved is
	 switching to Go modules).

 - `pkg` - kustomize packages for export

	 This should shrink in later versions, since
	 the surface area is too large, containing
	 sub-packages that should be in 'internal'.

 - `plugin` - holds main programs for plugins

This PR changes the top level go.mod file from

```
module sigs.k8s.io/kustomize
```

to

```
module sigs.k8s.io/kustomize/v3
```

and adjusts all import statements to
reflect the change.

pkg/plugins/compiler.go

@@ -25,7 +25,7 @@ import (
 	"strings"
 	"time"
 
-	"sigs.k8s.io/kustomize/pkg/pgmconfig"
+	"sigs.k8s.io/kustomize/v3/pkg/pgmconfig"
 )
 
 // Compiler creates Go plugin object files.

pkg/plugins/compiler_test.go

@@ -22,7 +22,7 @@ import (
 	"path/filepath"
 	"testing"
 
-	. "sigs.k8s.io/kustomize/pkg/plugins"
+	. "sigs.k8s.io/kustomize/v3/pkg/plugins"
 )
 
 // Regression coverage over compiler behavior.

pkg/plugins/config.go

@@ -7,8 +7,8 @@ import (
 	"fmt"
 	"github.com/spf13/pflag"
 	"path/filepath"
-	"sigs.k8s.io/kustomize/pkg/pgmconfig"
-	"sigs.k8s.io/kustomize/pkg/types"
+	"sigs.k8s.io/kustomize/v3/pkg/pgmconfig"
+	"sigs.k8s.io/kustomize/v3/pkg/types"
 )
 
 const (

pkg/plugins/envfortest.go

@@ -0,0 +1,110 @@
+// Copyright 2019 The Kubernetes Authors.
+// SPDX-License-Identifier: Apache-2.0
+
+package plugins
+
+import (
+	"io/ioutil"
+	"os"
+	"os/exec"
+	"path/filepath"
+	"strings"
+	"testing"
+
+	"sigs.k8s.io/kustomize/v3/pkg/pgmconfig"
+)
+
+// EnvForTest manages the plugin test environment.
+// It sets/resets XDG_CONFIG_HOME, makes/removes a temp objRoot.
+type EnvForTest struct {
+	t        *testing.T
+	compiler *Compiler
+	workDir  string
+	oldXdg   string
+	wasSet   bool
+}
+
+func NewEnvForTest(t *testing.T) *EnvForTest {
+	return &EnvForTest{t: t}
+}
+
+func (x *EnvForTest) Set() *EnvForTest {
+	x.createWorkDir()
+	x.compiler = x.makeCompiler()
+	x.setEnv()
+	return x
+}
+
+func (x *EnvForTest) Reset() {
+	x.resetEnv()
+	x.removeWorkDir()
+}
+
+func (x *EnvForTest) BuildGoPlugin(g, v, k string) {
+	err := x.compiler.Compile(g, v, k)
+	if err != nil {
+		x.t.Errorf("compile failed: %v", err)
+	}
+}
+
+func (x *EnvForTest) BuildExecPlugin(g, v, k string) {
+	lowK := strings.ToLower(k)
+	obj := filepath.Join(x.compiler.ObjRoot(), g, v, lowK, k)
+	src := filepath.Join(x.compiler.SrcRoot(), g, v, lowK, k)
+	if err := os.MkdirAll(filepath.Dir(obj), 0755); err != nil {
+		x.t.Errorf("error making directory: %s", filepath.Dir(obj))
+	}
+	cmd := exec.Command("cp", src, obj)
+	cmd.Env = os.Environ()
+	if err := cmd.Run(); err != nil {
+		x.t.Errorf("error copying %s to %s: %v", src, obj, err)
+	}
+}
+
+func (x *EnvForTest) makeCompiler() *Compiler {
+	// The plugin loader wants to find object code under
+	//    $XDG_CONFIG_HOME/kustomize/plugins
+	// and the compiler writes object code to
+	//    $objRoot
+	// so set things up accordingly.
+	objRoot := filepath.Join(
+		x.workDir, pgmconfig.ProgramName, pgmconfig.PluginRoot)
+	err := os.MkdirAll(objRoot, os.ModePerm)
+	if err != nil {
+		x.t.Error(err)
+	}
+	srcRoot, err := DefaultSrcRoot()
+	if err != nil {
+		x.t.Error(err)
+	}
+	return NewCompiler(srcRoot, objRoot)
+}
+
+func (x *EnvForTest) createWorkDir() {
+	var err error
+	x.workDir, err = ioutil.TempDir("", "kustomize-plugin-tests")
+	if err != nil {
+		x.t.Errorf("failed to make work dir: %v", err)
+	}
+}
+
+func (x *EnvForTest) removeWorkDir() {
+	err := os.RemoveAll(x.workDir)
+	if err != nil {
+		x.t.Errorf(
+			"removing work dir: %s %v", x.workDir, err)
+	}
+}
+
+func (x *EnvForTest) setEnv() {
+	x.oldXdg, x.wasSet = os.LookupEnv(pgmconfig.XDG_CONFIG_HOME)
+	os.Setenv(pgmconfig.XDG_CONFIG_HOME, x.workDir)
+}
+
+func (x *EnvForTest) resetEnv() {
+	if x.wasSet {
+		os.Setenv(pgmconfig.XDG_CONFIG_HOME, x.oldXdg)
+	} else {
+		os.Unsetenv(pgmconfig.XDG_CONFIG_HOME)
+	}
+}

pkg/plugins/execplugin.go

@@ -25,9 +25,9 @@ import (
 	"strings"
 	"syscall"
 
-	"sigs.k8s.io/kustomize/pkg/ifc"
-	"sigs.k8s.io/kustomize/pkg/resid"
-	"sigs.k8s.io/kustomize/pkg/resmap"
+	"sigs.k8s.io/kustomize/v3/pkg/ifc"
+	"sigs.k8s.io/kustomize/v3/pkg/resid"
+	"sigs.k8s.io/kustomize/v3/pkg/resmap"
 	"sigs.k8s.io/yaml"
 )
 

pkg/plugins/execplugin_test.go

@@ -20,10 +20,10 @@ import (
 	"strings"
 	"testing"
 
-	"sigs.k8s.io/kustomize/internal/loadertest"
-	"sigs.k8s.io/kustomize/k8sdeps/kunstruct"
-	"sigs.k8s.io/kustomize/pkg/resmap"
-	"sigs.k8s.io/kustomize/pkg/resource"
+	"sigs.k8s.io/kustomize/v3/internal/loadertest"
+	"sigs.k8s.io/kustomize/v3/k8sdeps/kunstruct"
+	"sigs.k8s.io/kustomize/v3/pkg/resmap"
+	"sigs.k8s.io/kustomize/v3/pkg/resource"
 )
 
 func TestExecPluginConfig(t *testing.T) {

pkg/plugins/loader.go

@@ -10,12 +10,12 @@ import (
 	"strings"
 
 	"github.com/pkg/errors"
-	"sigs.k8s.io/kustomize/pkg/ifc"
-	"sigs.k8s.io/kustomize/pkg/resid"
-	"sigs.k8s.io/kustomize/pkg/resmap"
-	"sigs.k8s.io/kustomize/pkg/resource"
-	"sigs.k8s.io/kustomize/pkg/transformers"
-	"sigs.k8s.io/kustomize/pkg/types"
+	"sigs.k8s.io/kustomize/v3/pkg/ifc"
+	"sigs.k8s.io/kustomize/v3/pkg/resid"
+	"sigs.k8s.io/kustomize/v3/pkg/resmap"
+	"sigs.k8s.io/kustomize/v3/pkg/resource"
+	"sigs.k8s.io/kustomize/v3/pkg/transformers"
+	"sigs.k8s.io/kustomize/v3/pkg/types"
 )
 
 type Configurable interface {

pkg/plugins/loader_test.go

@@ -6,12 +6,11 @@ package plugins_test
 import (
 	"testing"
 
-	"sigs.k8s.io/kustomize/internal/loadertest"
-	"sigs.k8s.io/kustomize/k8sdeps/kunstruct"
-	. "sigs.k8s.io/kustomize/pkg/plugins"
-	"sigs.k8s.io/kustomize/pkg/resmap"
-	"sigs.k8s.io/kustomize/pkg/resource"
-	"sigs.k8s.io/kustomize/plugin"
+	"sigs.k8s.io/kustomize/v3/internal/loadertest"
+	"sigs.k8s.io/kustomize/v3/k8sdeps/kunstruct"
+	. "sigs.k8s.io/kustomize/v3/pkg/plugins"
+	"sigs.k8s.io/kustomize/v3/pkg/resmap"
+	"sigs.k8s.io/kustomize/v3/pkg/resource"
 )
 
 const (
@@ -42,7 +41,7 @@ port: "12345"
 )
 
 func TestLoader(t *testing.T) {
-	tc := plugin.NewEnvForTest(t).Set()
+	tc := NewEnvForTest(t).Set()
 	defer tc.Reset()
 
 	tc.BuildGoPlugin(