update client-go version

2026-07-17 01:39:06 +00:00 · 2019-08-15 16:55:44 -07:00
549 changed files with 9475 additions and 40985 deletions
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,11 +1,7 @@
 os:
  - linux
-# TODO: Uncomment this when someone figures out how
+  - osx
-# to speed up the slowness of homebrew installation on
+# TODO: Uncomment when tests running on Windows.
 # oxs; presumably cache images?
 #  - osx
 #
 # TODO: Uncomment when some gets the tests running on Windows.
 #  - windows
 addons:
@@ -24,12 +20,18 @@ git:
 language: go
 go:
-  - "1.13"
+  - "1.12"
 go_import_path: sigs.k8s.io/kustomize
 before_install:
  - source ./travis/consider-early-travis-exit.sh
  - curl -sfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh| sh -s -- -b $(go env GOPATH)/bin v1.17.1
  - go get -u github.com/monopole/mdrip
  # The following would install Helm if needed for some reason.
  # - wget https://storage.googleapis.com/kubernetes-helm/helm-v2.13.1-linux-amd64.tar.gz
  # - tar -xvzf helm-v2.13.1-linux-amd64.tar.gz
  # - sudo mv linux-amd64/helm /usr/local/bin/helm
 # Skip the install process; let pre-commit.sh do it.
 install: true
--- a/37
+++ b/37
@@ -1,37 +0,0 @@
 BIN_NAME=kustomize
 COVER_FILE=coverage.out
 export GO111MODULE=on
 all: test build
 test: generate-code test-lint test-go
 test-go:
 	go test -v ./...
 test-lint:
 	golangci-lint run ./...
 generate-code:
 	./plugin/generateBuiltins.sh $(GOPATH)
 build:
 	go build -o $(BIN_NAME) cmd/kustomize/main.go
 install:
 	go install $(PWD)/cmd/kustomize
 cover:
 	# The plugin directory eludes coverage, and is therefore omitted
 	go test ./pkg/... ./k8sdeps/... ./internal/... -coverprofile=$(COVER_FILE) && \
 	go tool cover -html=$(COVER_FILE)
 clean:
 	go clean
 	rm -f $(BIN_NAME)
 	rm -f $(COVER_FILE)
 .PHONY: test build install clean generate-code test-go test-lint cover
--- a/README.md
+++ b/README.md
@@ -22,17 +22,8 @@ these [instructions](docs/INSTALL.md).
 Browse the [docs](docs) or jump right into the
 tested [examples](examples).
-## kubectl integration
+kustomize [v2.0.3] is available in [kubectl v1.15][kubectl].
 Since [v1.14][kubectl announcement] the kustomize build system has been included in kubectl.
 | kubectl version | kustomize version |
 |---------|--------|
 | v1.16.0 | [v2.0.3](https://github.com/kubernetes-sigs/kustomize/tree/v2.0.3) |
 | v1.15.x | [v2.0.3](https://github.com/kubernetes-sigs/kustomize/tree/v2.0.3) |
 | v1.14.x | [v2.0.3](https://github.com/kubernetes-sigs/kustomize/tree/v2.0.3) |
 For examples and guides for using the kubectl integration please see the [kubectl book] or the [kubernetes documentation].
 ## Usage
@@ -168,9 +159,7 @@ is governed by the [Kubernetes Code of Conduct].
 [imageBase]: docs/images/base.jpg
 [imageOverlay]: docs/images/overlay.jpg
 [kind/feature]: https://github.com/kubernetes-sigs/kustomize/labels/kind%2Ffeature
-[kubectl announcement]: https://kubernetes.io/blog/2019/03/25/kubernetes-1-14-release-announcement
+[kubectl]: https://kubernetes.io/blog/2019/03/25/kubernetes-1-14-release-announcement
 [kubectl book]: https://kubectl.docs.kubernetes.io/pages/app_customization/introduction.html
 [kubernetes documentation]: https://kubernetes.io/docs/tasks/manage-kubernetes-objects/kustomization/
 [kubernetes style]: docs/glossary.md#kubernetes-style-object
 [kustomization]: docs/glossary.md#kustomization
 [overlay]: docs/glossary.md#overlay
--- a/api/filesys/file.go
+++ b/api/filesys/file.go
@@ -1,41 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys
 import (
 	"io"
 	"os"
 	"time"
 )
 var _ os.FileInfo = &fileInfo{}
 // fileInfo implements os.FileInfo for a fileInMemory instance.
 type fileInfo struct {
 	*fileInMemory
 }
 // Name returns the name of the file
 func (fi *fileInfo) Name() string { return fi.name }
 // Size returns the size of the file
 func (fi *fileInfo) Size() int64 { return int64(len(fi.content)) }
 // Mode returns the file mode
 func (fi *fileInfo) Mode() os.FileMode { return 0777 }
 // ModTime returns the modification time
 func (fi *fileInfo) ModTime() time.Time { return time.Time{} }
 // IsDir returns if it is a directory
 func (fi *fileInfo) IsDir() bool { return fi.dir }
 // Sys should return underlying data source, but it now returns nil
 func (fi *fileInfo) Sys() interface{} { return nil }
 // File groups the basic os.File methods.
 type File interface {
 	io.ReadWriteCloser
 	Stat() (os.FileInfo, error)
 }
--- a/api/filesys/fileinmemory.go
+++ b/api/filesys/fileinmemory.go
@@ -1,56 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys
 import (
 	"bytes"
 	"os"
 )
 var _ File = &fileInMemory{}
 // fileInMemory implements File in-memory for tests.
 type fileInMemory struct {
 	name    string
 	content []byte
 	dir     bool
 	open    bool
 }
 // makeDir makes a fake directory.
 func makeDir(name string) *fileInMemory {
 	return &fileInMemory{name: name, dir: true}
 }
 // Close marks the fake file closed.
 func (f *fileInMemory) Close() error {
 	f.open = false
 	return nil
 }
 // Read never fails, and doesn't mutate p.
 func (f *fileInMemory) Read(p []byte) (n int, err error) {
 	return len(p), nil
 }
 // Write saves the contents of the argument to memory.
 func (f *fileInMemory) Write(p []byte) (n int, err error) {
 	f.content = p
 	return len(p), nil
 }
 // ContentMatches returns true if v matches fake file's content.
 func (f *fileInMemory) ContentMatches(v []byte) bool {
 	return bytes.Equal(v, f.content)
 }
 // GetContent the content of a fake file.
 func (f *fileInMemory) GetContent() []byte {
 	return f.content
 }
 // Stat returns nil.
 func (f *fileInMemory) Stat() (os.FileInfo, error) {
 	return nil, nil
 }
--- a/api/filesys/fileondisk.go
+++ b/api/filesys/fileondisk.go
@@ -1,27 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys
 import (
 	"os"
 )
 var _ File = &fileOnDisk{}
 // fileOnDisk implements File using the local filesystem.
 type fileOnDisk struct {
 	file *os.File
 }
 // Close closes a file.
 func (f *fileOnDisk) Close() error { return f.file.Close() }
 // Read reads a file's content.
 func (f *fileOnDisk) Read(p []byte) (n int, err error) { return f.file.Read(p) }
 // Write writes bytes to a file
 func (f *fileOnDisk) Write(p []byte) (n int, err error) { return f.file.Write(p) }
 // Stat returns an interface which has all the information regarding the file.
 func (f *fileOnDisk) Stat() (os.FileInfo, error) { return f.file.Stat() }
--- a/api/filesys/filesystem.go
+++ b/api/filesys/filesystem.go
@@ -1,41 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package filesys provides a file system abstraction layer.
 package filesys
 import (
 	"path/filepath"
 )
 // FileSystem groups basic os filesystem methods.
 type FileSystem interface {
 	// Create a file.
 	Create(name string) (File, error)
 	// MkDir makes a directory.
 	Mkdir(path string) error
 	// MkDir makes a directory path, creating intervening directories.
 	MkdirAll(path string) error
 	// RemoveAll removes path and any children it contains.
 	RemoveAll(path string) error
 	// Open opens the named file for reading.
 	Open(path string) (File, error)
 	// IsDir returns true if the path is a directory.
 	IsDir(path string) bool
 	// CleanedAbs converts the given path into a
 	// directory and a file name, where the directory
 	// is represented as a ConfirmedDir and all that implies.
 	// If the entire path is a directory, the file component
 	// is an empty string.
 	CleanedAbs(path string) (ConfirmedDir, string, error)
 	// Exists is true if the path exists in the file system.
 	Exists(path string) bool
 	// Glob returns the list of matching files
 	Glob(pattern string) ([]string, error)
 	// ReadFile returns the contents of the file at the given path.
 	ReadFile(path string) ([]byte, error)
 	// WriteFile writes the data to a file at the given path.
 	WriteFile(path string, data []byte) error
 	// Walk walks the file system with the given WalkFunc.
 	Walk(path string, walkFn filepath.WalkFunc) error
 }
--- a/api/filesys/fsinmemory.go
+++ b/api/filesys/fsinmemory.go
@@ -1,223 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys
 import (
 	"fmt"
 	"os"
 	"path/filepath"
 	"sort"
 	"strings"
 )
 var _ FileSystem = &fsInMemory{}
 // fsInMemory implements FileSystem using a in-memory filesystem
 // primarily for use in tests.
 type fsInMemory struct {
 	m map[string]*fileInMemory
 }
 // MakeFsInMemory returns an instance of fsInMemory with no files in it.
 func MakeFsInMemory() FileSystem {
 	result := &fsInMemory{m: map[string]*fileInMemory{}}
 	result.Mkdir(separator)
 	return result
 }
 const (
 	separator = string(filepath.Separator)
 	doubleSep = separator + separator
 )
 // Create assures a fake file appears in the in-memory file system.
 func (fs *fsInMemory) Create(name string) (File, error) {
 	f := &fileInMemory{}
 	f.open = true
 	fs.m[name] = f
 	return fs.m[name], nil
 }
 // Mkdir assures a fake directory appears in the in-memory file system.
 func (fs *fsInMemory) Mkdir(name string) error {
 	fs.m[name] = makeDir(name)
 	return nil
 }
 // MkdirAll delegates to Mkdir
 func (fs *fsInMemory) MkdirAll(name string) error {
 	return fs.Mkdir(name)
 }
 // RemoveAll presumably does rm -r on a path.
 // There's no error.
 func (fs *fsInMemory) RemoveAll(name string) error {
 	var toRemove []string
 	for k := range fs.m {
 		if strings.HasPrefix(k, name) {
 			toRemove = append(toRemove, k)
 		}
 	}
 	for _, k := range toRemove {
 		delete(fs.m, k)
 	}
 	return nil
 }
 // Open returns a fake file in the open state.
 func (fs *fsInMemory) Open(name string) (File, error) {
 	if _, found := fs.m[name]; !found {
 		return nil, fmt.Errorf("file %q cannot be opened", name)
 	}
 	return fs.m[name], nil
 }
 // CleanedAbs cannot fail.
 func (fs *fsInMemory) CleanedAbs(path string) (ConfirmedDir, string, error) {
 	if fs.IsDir(path) {
 		return ConfirmedDir(path), "", nil
 	}
 	d := filepath.Dir(path)
 	if d == path {
 		return ConfirmedDir(d), "", nil
 	}
 	return ConfirmedDir(d), filepath.Base(path), nil
 }
 // Exists returns true if file is known.
 func (fs *fsInMemory) Exists(name string) bool {
 	_, found := fs.m[name]
 	return found
 }
 // Glob returns the list of matching files
 func (fs *fsInMemory) Glob(pattern string) ([]string, error) {
 	var result []string
 	for p := range fs.m {
 		if fs.pathMatch(p, pattern) {
 			result = append(result, p)
 		}
 	}
 	sort.Strings(result)
 	return result, nil
 }
 // IsDir returns true if the file exists and is a directory.
 func (fs *fsInMemory) IsDir(name string) bool {
 	f, found := fs.m[name]
 	if found && f.dir {
 		return true
 	}
 	if !strings.HasSuffix(name, separator) {
 		name = name + separator
 	}
 	for k := range fs.m {
 		if strings.HasPrefix(k, name) {
 			return true
 		}
 	}
 	return false
 }
 // ReadFile always returns an empty bytes and error depending on content of m.
 func (fs *fsInMemory) ReadFile(name string) ([]byte, error) {
 	if ff, found := fs.m[name]; found {
 		return ff.content, nil
 	}
 	return nil, fmt.Errorf("cannot read file %q", name)
 }
 // WriteFile always succeeds and does nothing.
 func (fs *fsInMemory) WriteFile(name string, c []byte) error {
 	ff := &fileInMemory{}
 	ff.Write(c)
 	fs.m[name] = ff
 	return nil
 }
 // Walk implements filepath.Walk using the fake filesystem.
 func (fs *fsInMemory) Walk(path string, walkFn filepath.WalkFunc) error {
 	info, err := fs.lstat(path)
 	if err != nil {
 		err = walkFn(path, info, err)
 	} else {
 		err = fs.walk(path, info, walkFn)
 	}
 	if err == filepath.SkipDir {
 		return nil
 	}
 	return err
 }
 func (fs *fsInMemory) pathMatch(path, pattern string) bool {
 	match, _ := filepath.Match(pattern, path)
 	return match
 }
 func (fs *fsInMemory) lstat(path string) (*fileInfo, error) {
 	f, found := fs.m[path]
 	if !found {
 		return nil, os.ErrNotExist
 	}
 	return &fileInfo{f}, nil
 }
 func (fs *fsInMemory) join(elem ...string) string {
 	for i, e := range elem {
 		if e != "" {
 			return strings.Replace(
 				strings.Join(elem[i:], separator), doubleSep, separator, -1)
 		}
 	}
 	return ""
 }
 func (fs *fsInMemory) readDirNames(path string) []string {
 	var names []string
 	if !strings.HasSuffix(path, separator) {
 		path += separator
 	}
 	pathSegments := strings.Count(path, separator)
 	for name := range fs.m {
 		if name == path {
 			continue
 		}
 		if strings.Count(name, separator) > pathSegments {
 			continue
 		}
 		if strings.HasPrefix(name, path) {
 			names = append(names, filepath.Base(name))
 		}
 	}
 	sort.Strings(names)
 	return names
 }
 func (fs *fsInMemory) walk(path string, info os.FileInfo, walkFn filepath.WalkFunc) error {
 	if !info.IsDir() {
 		return walkFn(path, info, nil)
 	}
 	names := fs.readDirNames(path)
 	if err := walkFn(path, info, nil); err != nil {
 		return err
 	}
 	for _, name := range names {
 		filename := fs.join(path, name)
 		fileInfo, err := fs.lstat(filename)
 		if err != nil {
 			if err := walkFn(filename, fileInfo, os.ErrNotExist); err != nil && err != filepath.SkipDir {
 				return err
 			}
 		} else {
 			err = fs.walk(filename, fileInfo, walkFn)
 			if err != nil {
 				if !fileInfo.IsDir() || err != filepath.SkipDir {
 					return err
 				}
 			}
 		}
 	}
 	return nil
 }
--- a/api/filesys/fsinmemory_test.go
+++ b/api/filesys/fsinmemory_test.go
@@ -1,149 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys_test
 import (
 	"bytes"
 	"reflect"
 	"testing"
 	. "sigs.k8s.io/kustomize/api/filesys"
 )
 func TestExists(t *testing.T) {
 	fSys := MakeFsInMemory()
 	if fSys.Exists("foo") {
 		t.Fatalf("expected no foo")
 	}
 	fSys.Mkdir("/")
 	if !fSys.IsDir("/") {
 		t.Fatalf("expected dir at /")
 	}
 }
 func TestIsDir(t *testing.T) {
 	fSys := MakeFsInMemory()
 	expectedName := "my-dir"
 	err := fSys.Mkdir(expectedName)
 	if err != nil {
 		t.Fatalf("unexpected error: %v", err)
 	}
 	shouldExist(t, fSys, expectedName)
 	if !fSys.IsDir(expectedName) {
 		t.Fatalf(expectedName + " should be a dir")
 	}
 }
 func shouldExist(t *testing.T, fSys FileSystem, name string) {
 	if !fSys.Exists(name) {
 		t.Fatalf(name + " should exist")
 	}
 }
 func shouldNotExist(t *testing.T, fSys FileSystem, name string) {
 	if fSys.Exists(name) {
 		t.Fatalf(name + " should not exist")
 	}
 }
 func TestRemoveAll(t *testing.T) {
 	fSys := MakeFsInMemory()
 	fSys.WriteFile("/foo/project/file.yaml", []byte("Unused"))
 	fSys.WriteFile("/foo/project/subdir/file.yaml", []byte("Unused"))
 	fSys.WriteFile("/foo/apple/subdir/file.yaml", []byte("Unused"))
 	shouldExist(t, fSys, "/foo/project/file.yaml")
 	shouldExist(t, fSys, "/foo/project/subdir/file.yaml")
 	shouldExist(t, fSys, "/foo/apple/subdir/file.yaml")
 	err := fSys.RemoveAll("/foo/project")
 	if err != nil {
 		t.Fatalf("Unexpected error: %v", err)
 	}
 	shouldNotExist(t, fSys, "/foo/project/file.yaml")
 	shouldNotExist(t, fSys, "/foo/project/subdir/file.yaml")
 	shouldExist(t, fSys, "/foo/apple/subdir/file.yaml")
 }
 func TestIsDirDeeper(t *testing.T) {
 	fSys := MakeFsInMemory()
 	fSys.WriteFile("/foo/project/file.yaml", []byte("Unused"))
 	fSys.WriteFile("/foo/project/subdir/file.yaml", []byte("Unused"))
 	if !fSys.IsDir("/") {
 		t.Fatalf("/ should be a dir")
 	}
 	if !fSys.IsDir("/foo") {
 		t.Fatalf("/foo should be a dir")
 	}
 	if !fSys.IsDir("/foo/project") {
 		t.Fatalf("/foo/project should be a dir")
 	}
 	if fSys.IsDir("/fo") {
 		t.Fatalf("/fo should not be a dir")
 	}
 	if fSys.IsDir("/x") {
 		t.Fatalf("/x should not be a dir")
 	}
 }
 func TestCreate(t *testing.T) {
 	fSys := MakeFsInMemory()
 	f, err := fSys.Create("foo")
 	if f == nil {
 		t.Fatalf("expected file")
 	}
 	if err != nil {
 		t.Fatalf("unexpected error")
 	}
 	shouldExist(t, fSys, "foo")
 }
 func TestReadFile(t *testing.T) {
 	fSys := MakeFsInMemory()
 	f, err := fSys.Create("foo")
 	if f == nil {
 		t.Fatalf("expected file")
 	}
 	if err != nil {
 		t.Fatalf("unexpected error")
 	}
 	content, err := fSys.ReadFile("foo")
 	if len(content) != 0 {
 		t.Fatalf("expected no content")
 	}
 	if err != nil {
 		t.Fatalf("expected no error")
 	}
 }
 func TestWriteFile(t *testing.T) {
 	fSys := MakeFsInMemory()
 	c := []byte("heybuddy")
 	err := fSys.WriteFile("foo", c)
 	if err != nil {
 		t.Fatalf("expected no error")
 	}
 	content, err := fSys.ReadFile("foo")
 	if err != nil {
 		t.Fatalf("expected read to work: %v", err)
 	}
 	if bytes.Compare(c, content) != 0 {
 		t.Fatalf("incorrect content: %v", content)
 	}
 }
 func TestGlob(t *testing.T) {
 	fSys := MakeFsInMemory()
 	fSys.Create("dir/foo")
 	fSys.Create("dir/bar")
 	files, err := fSys.Glob("dir/*")
 	if err != nil {
 		t.Fatalf("expected no error")
 	}
 	expected := []string{
 		"dir/bar",
 		"dir/foo",
 	}
 	if !reflect.DeepEqual(files, expected) {
 		t.Fatalf("incorrect files found by glob: %v", files)
 	}
 }
--- a/api/filesys/rpath.go
+++ b/api/filesys/rpath.go
@@ -1,12 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package filesys
 import "path/filepath"
 // RootedPath returns a rooted path, e.g. "/foo/bar" as
 // opposed to "foo/bar".
 func RootedPath(elem ...string) string {
 	return separator + filepath.Join(elem...)
 }
--- a/api/go.mod
+++ b/api/go.mod
@@ -1,21 +0,0 @@
 module sigs.k8s.io/kustomize/api
 go 1.13
 require (
 	github.com/evanphx/json-patch v4.5.0+incompatible
 	github.com/go-openapi/spec v0.19.4
 	github.com/golang/protobuf v1.3.2 // indirect
 	github.com/pkg/errors v0.8.1
 	github.com/spf13/pflag v1.0.5
 	github.com/stretchr/testify v1.4.0 // indirect
 	golang.org/x/net v0.0.0-20190923162816-aa69164e4478 // indirect
 	golang.org/x/sys v0.0.0-20190922100055-0a153f010e69 // indirect
 	gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 // indirect
 	gopkg.in/yaml.v2 v2.2.4
 	k8s.io/api v0.0.0-20191016225839-816a9b7df678
 	k8s.io/apimachinery v0.0.0-20191020214737-6c8691705fc5
 	k8s.io/client-go v11.0.0+incompatible
 	k8s.io/kube-openapi v0.0.0-20190918143330-0270cf2f1c1d
 	sigs.k8s.io/yaml v1.1.0
 )
--- a/api/go.sum
+++ b/api/go.sum
@@ -1,162 +0,0 @@
 github.com/NYTimes/gziphandler v0.0.0-20170623195520-56545f4a5d46/go.mod h1:3wb06e3pkSAbeQ52E9H9iFoQsEEwGN64994WTCIhntQ=
 github.com/PuerkitoBio/purell v1.0.0/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0=
 github.com/PuerkitoBio/purell v1.1.1 h1:WEQqlqaGbrPkxLJWfBwQmfEAE1Z7ONdDLqrN38tNFfI=
 github.com/PuerkitoBio/purell v1.1.1/go.mod h1:c11w/QuzBsJSee3cPx9rAFu61PvFxuPbtSwDGJws/X0=
 github.com/PuerkitoBio/urlesc v0.0.0-20160726150825-5bd2802263f2/go.mod h1:uGdkoq3SwY9Y+13GIhn11/XLaGBb4BfwItxLd5jeuXE=
 github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578 h1:d+Bc7a5rLufV/sSk/8dngufqelfh6jnri85riMAaF/M=
 github.com/PuerkitoBio/urlesc v0.0.0-20170810143723-de5bf2ad4578/go.mod h1:uGdkoq3SwY9Y+13GIhn11/XLaGBb4BfwItxLd5jeuXE=
 github.com/davecgh/go-spew v0.0.0-20151105211317-5215b55f46b2/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/docker/spdystream v0.0.0-20160310174837-449fdfce4d96/go.mod h1:Qh8CwZgvJUkLughtfhJv5dyTYa91l1fOUCrgjqmcifM=
 github.com/elazarl/goproxy v0.0.0-20170405201442-c4fc26588b6e/go.mod h1:/Zj4wYkgs4iZTTu3o/KG3Itv/qCCa8VVMlb3i9OVuzc=
 github.com/emicklei/go-restful v0.0.0-20170410110728-ff4f55a20633 h1:H2pdYOb3KQ1/YsqVWoWNLQO+fusocsw354rqGTZtAgw=
 github.com/emicklei/go-restful v0.0.0-20170410110728-ff4f55a20633/go.mod h1:otzb+WCGbkyDHkqmQmT5YD2WR4BBwUdeQoFo8l/7tVs=
 github.com/evanphx/json-patch v4.2.0+incompatible/go.mod h1:50XU6AFN0ol/bzJsmQLiYLvXMP4fmwYFNcr97nuDLSk=
 github.com/evanphx/json-patch v4.5.0+incompatible h1:ouOWdg56aJriqS0huScTkVXPC5IcNrDCXZ6OoTAWu7M=
 github.com/evanphx/json-patch v4.5.0+incompatible/go.mod h1:50XU6AFN0ol/bzJsmQLiYLvXMP4fmwYFNcr97nuDLSk=
 github.com/fsnotify/fsnotify v1.4.7 h1:IXs+QLmnXW2CcXuY+8Mzv/fWEsPGWxqefPtCP5CnV9I=
 github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo=
 github.com/ghodss/yaml v0.0.0-20150909031657-73d445a93680/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04=
 github.com/go-logr/logr v0.1.0/go.mod h1:ixOQHD9gLJUVQQ2ZOR7zLEifBX6tGkNJF4QyIY7sIas=
 github.com/go-openapi/jsonpointer v0.0.0-20160704185906-46af16f9f7b1/go.mod h1:+35s3my2LFTysnkMfxsJBAMHj/DoqoB9knIWoYG/Vk0=
 github.com/go-openapi/jsonpointer v0.19.2/go.mod h1:3akKfEdA7DF1sugOqz1dVQHBcuDBPKZGEoHC/NkiQRg=
 github.com/go-openapi/jsonpointer v0.19.3 h1:gihV7YNZK1iK6Tgwwsxo2rJbD1GTbdm72325Bq8FI3w=
 github.com/go-openapi/jsonpointer v0.19.3/go.mod h1:Pl9vOtqEWErmShwVjC8pYs9cog34VGT37dQOVbmoatg=
 github.com/go-openapi/jsonreference v0.0.0-20160704190145-13c6e3589ad9/go.mod h1:W3Z9FmVs9qj+KR4zFKmDPGiLdk1D9Rlm7cyMvf57TTg=
 github.com/go-openapi/jsonreference v0.19.2 h1:o20suLFB4Ri0tuzpWtyHlh7E7HnkqTNLq6aR6WVNS1w=
 github.com/go-openapi/jsonreference v0.19.2/go.mod h1:jMjeRr2HHw6nAVajTXJ4eiUwohSTlpa0o73RUL1owJc=
 github.com/go-openapi/spec v0.0.0-20160808142527-6aced65f8501/go.mod h1:J8+jY1nAiCcj+friV/PDoE1/3eeccG9LYBs0tYvLOWc=
 github.com/go-openapi/spec v0.19.4 h1:ixzUSnHTd6hCemgtAJgluaTSGYpLNpJY4mA2DIkdOAo=
 github.com/go-openapi/spec v0.19.4/go.mod h1:FpwSN1ksY1eteniUU7X0N/BgJ7a4WvBFVA8Lj9mJglo=
 github.com/go-openapi/swag v0.0.0-20160704191624-1d0bd113de87/go.mod h1:DXUve3Dpr1UfpPtxFw+EFuQ41HhCWZfha5jSVRG7C7I=
 github.com/go-openapi/swag v0.19.2/go.mod h1:POnQmlKehdgb5mhVOsnJFsivZCEZ/vjK9gh66Z9tfKk=
 github.com/go-openapi/swag v0.19.5 h1:lTz6Ys4CmqqCQmZPBlbQENR1/GucA2bzYTE12Pw4tFY=
 github.com/go-openapi/swag v0.19.5/go.mod h1:POnQmlKehdgb5mhVOsnJFsivZCEZ/vjK9gh66Z9tfKk=
 github.com/gogo/protobuf v1.2.2-0.20190723190241-65acae22fc9d h1:3PaI8p3seN09VjbTYC/QWlUZdZ1qS1zGjy7LH2Wt07I=
 github.com/gogo/protobuf v1.2.2-0.20190723190241-65acae22fc9d/go.mod h1:SlYgWuQ5SjCEi6WLHjHCa1yvBfUnHcTbrrZtXPKa29o=
 github.com/golang/groupcache v0.0.0-20160516000752-02826c3e7903/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc=
 github.com/golang/protobuf v0.0.0-20161109072736-4bd1920723d7/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/golang/protobuf v1.3.2 h1:6nsPYzhq5kReh6QImI3k5qWzO4PEbvbIW2cwSfR/6xs=
 github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U=
 github.com/google/go-cmp v0.3.0 h1:crn/baboCvb5fXaQ0IJ1SGTsTVrWpDsCWC8EGETZijY=
 github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU=
 github.com/google/gofuzz v0.0.0-20161122191042-44d81051d367/go.mod h1:HP5RmnzzSNb993RKQDq4+1A4ia9nllfqcQFTQJedwGI=
 github.com/google/gofuzz v1.0.0 h1:A8PeW59pxE9IoFRqBp37U+mSNaQoZ46F1f0f863XSXw=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
 github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
 github.com/googleapis/gnostic v0.0.0-20170729233727-0c5108395e2d h1:7XGaL1e6bYS1yIonGp9761ExpPPV1ui0SAC59Yube9k=
 github.com/googleapis/gnostic v0.0.0-20170729233727-0c5108395e2d/go.mod h1:sJBsCZ4ayReDTBIg8b9dl28c5xFWyhBTVRp3pOg5EKY=
 github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8=
 github.com/hpcloud/tail v1.0.0 h1:nfCOvKYfkgYP8hkirhJocXT2+zOD8yUNjXaWfTlyFKI=
 github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU=
 github.com/json-iterator/go v0.0.0-20180612202835-f2b4162afba3/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU=
 github.com/json-iterator/go v1.1.7 h1:KfgG9LzI+pYjr4xvmz/5H4FXjokeP+rlHLhv3iH62Fo=
 github.com/json-iterator/go v1.1.7/go.mod h1:KdQUCv79m/52Kvf8AW2vK1V8akMuk1QjK/uOdHXbAo4=
 github.com/kisielk/errcheck v1.2.0/go.mod h1:/BMXB+zMLi60iA8Vv6Ksmxu/1UDYcXs4uQLJ+jE2L00=
 github.com/kisielk/gotool v1.0.0 h1:AV2c/EiW3KqPNT9ZKl07ehoAGi4C5/01Cfbblndcapg=
 github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck=
 github.com/kr/pretty v0.1.0 h1:L/CwN0zerZDmRFUapSPitk6f+Q3+0za1rQkzVuMiMFI=
 github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=
 github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=
 github.com/kr/pty v1.1.5/go.mod h1:9r2w37qlBe7rQ6e1fg1S/9xpWHSnaqNdHD3WcMdbPDA=
 github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE=
 github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=
 github.com/mailru/easyjson v0.0.0-20160728113105-d5b7844b561a/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc=
 github.com/mailru/easyjson v0.0.0-20190614124828-94de47d64c63/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc=
 github.com/mailru/easyjson v0.0.0-20190626092158-b2ccc519800e h1:hB2xlXdHp/pmPZq0y3QnmWAArdw9PqbmotexnWx/FU8=
 github.com/mailru/easyjson v0.0.0-20190626092158-b2ccc519800e/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc=
 github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w8PVh93nsPXa1VrQ6jlwL5oN8l14QlcNfg=
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v0.0.0-20180320133207-05fbef0ca5da/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
 github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
 github.com/modern-go/reflect2 v1.0.1 h1:9f412s+6RmYXLWZSEzVVgPGK7C2PphHj5RJrvfx9AWI=
 github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0=
 github.com/munnerz/goautoneg v0.0.0-20120707110453-a547fc61f48d/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
 github.com/mxk/go-flowrate v0.0.0-20140419014527-cca7078d478f/go.mod h1:ZdcZmHo+o7JKHSa8/e818NopupXU1YMK5fe1lsApnBw=
 github.com/onsi/ginkgo v0.0.0-20170829012221-11459a886d9c/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE=
 github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE=
 github.com/onsi/ginkgo v1.10.1 h1:q/mM8GF/n0shIN8SaAZ0V+jnLPzen6WIVZdiwrRlMlo=
 github.com/onsi/ginkgo v1.10.1/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE=
 github.com/onsi/gomega v0.0.0-20170829124025-dcabb60a477c/go.mod h1:C1qb7wdrVGGVU+Z6iS04AVkA3Q65CEZX59MT0QO5uiA=
 github.com/onsi/gomega v1.7.0 h1:XPnZz8VVBHjVsy1vzJmRwIcSwiUO+JFfrv/xGiigmME=
 github.com/onsi/gomega v1.7.0/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY=
 github.com/pkg/errors v0.8.1 h1:iURUrRGxPUNPdy5/HRSm+Yj6okJ6UtLINN0Q9M4+h3I=
 github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v0.0.0-20151028094244-d8ed2627bdf0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
 github.com/spf13/pflag v0.0.0-20170130214245-9ff6c6923cff/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4=
 github.com/spf13/pflag v1.0.3/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4=
 github.com/spf13/pflag v1.0.5 h1:iy+VFUOCP1a+8yFto/drg2CJ5u0yRoB7fZw3DKv/JXA=
 github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.2.0 h1:Hbg2NidpLE8veEBkEZTL3CvlkUIVzuU9jDplZO54c48=
 github.com/stretchr/objx v0.2.0/go.mod h1:qt09Ya8vawLte6SNmTgCsAVtYtaKzEcn8ATUoHMkEqE=
 github.com/stretchr/testify v0.0.0-20151208002404-e3a8ff8ce365/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
 github.com/stretchr/testify v1.4.0 h1:2E4SXV/wtOkTonXsotYi4li6zVWxYlZuYNCXe9XRJyk=
 github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20190611184440-5c40567a22f8/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
 golang.org/x/net v0.0.0-20170114055629-f2499483f923/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
 golang.org/x/net v0.0.0-20180906233101-161cd47e91fd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
 golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
 golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
 golang.org/x/net v0.0.0-20190613194153-d28f0bde5980/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20190812203447-cdfb69ac37fc/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4=
 golang.org/x/net v0.0.0-20190827160401-ba9fcec4b297/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/net v0.0.0-20190923162816-aa69164e4478 h1:l5EDrHhldLYb3ZRHDUhXF7Om7MvYXnkV9/iQNo1lX6g=
 golang.org/x/net v0.0.0-20190923162816-aa69164e4478/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
 golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
 golang.org/x/sys v0.0.0-20170830134202-bb24a47a89ea/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20190616124812-15dcb6c0061f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/sys v0.0.0-20190922100055-0a153f010e69 h1:rOhMmluY6kLMhdnrivzec6lLgaVbMHMn2ISQXJeJ5EM=
 golang.org/x/sys v0.0.0-20190922100055-0a153f010e69/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
 golang.org/x/text v0.0.0-20160726164857-2910a502d2bf/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.2 h1:tW2bmiBqwgJj/UpqtC8EpXEZVYOwU0yG4iWbprSVAcs=
 golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk=
 golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20181011042414-1f849cf54d09/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20181030221726-6c7e314b6563/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
 golang.org/x/tools v0.0.0-20190614205625-5aca471b1d59/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo=
 gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
 gopkg.in/fsnotify.v1 v1.4.7 h1:xOHLXZwVvI9hhs+cLKq5+I5onOuwQLhQwiu63xxlHs4=
 gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys=
 gopkg.in/inf.v0 v0.9.0 h1:3zYtXIO92bvsdS3ggAdA8Gb4Azj0YU+TVY1uGYNFA8o=
 gopkg.in/inf.v0 v0.9.0/go.mod h1:cWUDdTG/fYaXco+Dcufb5Vnc6Gp2YChqWtbxRZE0mXw=
 gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 h1:uRGJdciOHaEIrze2W8Q3AKkepLTh2hOroT7a+7czfdQ=
 gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw=
 gopkg.in/yaml.v2 v2.2.1/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v2 v2.2.4 h1:/eiJrUcujPVeJ3xlSWaiNi3uSVmDGBK1pDHUHAnao1I=
 gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 k8s.io/api v0.0.0-20191016225839-816a9b7df678 h1:z/0BV/tMBIvdwZvqBH/f7TWjQX9y3dj1nMNhrSK0h/8=
 k8s.io/api v0.0.0-20191016225839-816a9b7df678/go.mod h1:LZQaT8MvVpl7Bg2lYFcQm7+Mpdxq8p1NFl3yh+5DCwY=
 k8s.io/apimachinery v0.0.0-20191016225534-b1267f8c42b4/go.mod h1:92mWDd8Ji2sw2157KIgino5wCxffA8KSvhW2oY4ypdw=
 k8s.io/apimachinery v0.0.0-20191020214737-6c8691705fc5 h1:r3/YL3+t1U46lJF5zUSArskUpnLyWuM28rQDpM1qQPI=
 k8s.io/apimachinery v0.0.0-20191020214737-6c8691705fc5/go.mod h1:92mWDd8Ji2sw2157KIgino5wCxffA8KSvhW2oY4ypdw=
 k8s.io/client-go v11.0.0+incompatible h1:LBbX2+lOwY9flffWlJM7f1Ct8V2SRNiMRDFeiwnJo9o=
 k8s.io/client-go v11.0.0+incompatible/go.mod h1:7vJpHMYJwNQCWgzmNV+VYUl1zCObLyodBc8nIyt8L5s=
 k8s.io/gengo v0.0.0-20190128074634-0689ccc1d7d6/go.mod h1:ezvh/TsK7cY6rbqRK0oQQ8IAqLxYwwyPxAX1Pzy0ii0=
 k8s.io/klog v0.0.0-20181102134211-b9b56d5dfc92/go.mod h1:Gq+BEi5rUBO/HRz0bTSXDUcqjScdoY3a9IHpCEIOOfk=
 k8s.io/klog v1.0.0 h1:Pt+yjF5aB1xDSVbau4VsWe+dQNzA0qv1LlXdC2dF6Q8=
 k8s.io/klog v1.0.0/go.mod h1:4Bi6QPql/J/LkTDqv7R/cd3hPo4k2DG6Ptcz060Ez5I=
 k8s.io/kube-openapi v0.0.0-20190816220812-743ec37842bf/go.mod h1:1TqjTSzOxsLGIKfj0lK8EeCP7K1iUG65v09OM0/WG5E=
 k8s.io/kube-openapi v0.0.0-20190918143330-0270cf2f1c1d h1:Xpe6sK+RY4ZgCTyZ3y273UmFmURhjtoJiwOMbQsXitY=
 k8s.io/kube-openapi v0.0.0-20190918143330-0270cf2f1c1d/go.mod h1:1TqjTSzOxsLGIKfj0lK8EeCP7K1iUG65v09OM0/WG5E=
 sigs.k8s.io/structured-merge-diff v0.0.0-20190525122527-15d366b2352e/go.mod h1:wWxsB5ozmmv/SG7nM11ayaAW51xMvak/t1r0CSlcokI=
 sigs.k8s.io/yaml v1.1.0 h1:4A07+ZFc2wgJwo8YNlQpr1rVlgUDlxXHhPJciaPY5gs=
 sigs.k8s.io/yaml v1.1.0/go.mod h1:UJmg0vDUVViEyp3mgSv9WPwZCDxu4rQW1olrI1uml+o=
--- a/api/internal/accumulator/namereferencetransformer.go
+++ b/api/internal/accumulator/namereferencetransformer.go
@@ -1,274 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package accumulator
 import (
 	"fmt"
 	"log"
 	"sigs.k8s.io/kustomize/api/plugins/builtinconfig"
 	"sigs.k8s.io/kustomize/api/resid"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	"sigs.k8s.io/kustomize/api/transform"
 )
 type nameReferenceTransformer struct {
 	backRefs []builtinconfig.NameBackReferences
 }
 var _ resmap.Transformer = &nameReferenceTransformer{}
 // newNameReferenceTransformer constructs a nameReferenceTransformer
 // with a given slice of NameBackReferences.
 func newNameReferenceTransformer(br []builtinconfig.NameBackReferences) resmap.Transformer {
 	if br == nil {
 		log.Fatal("backrefs not expected to be nil")
 	}
 	return &nameReferenceTransformer{backRefs: br}
 }
 // Transform updates name references in resource A that
 // refer to resource B, given that B's name may have
 // changed.
 //
 // For example, a HorizontalPodAutoscaler (HPA)
 // necessarily refers to a Deployment, the thing that
 // the HPA scales. The Deployment name might change
 // (e.g. prefix added), and the reference in the HPA
 // has to be fixed.
 //
 // In the outer loop over the ResMap below, say we
 // encounter a specific HPA. Then, in scanning backrefs,
 // we encounter an entry like
 //
 //   - kind: Deployment
 //     fieldSpecs:
 //     - kind: HorizontalPodAutoscaler
 //       path: spec/scaleTargetRef/name
 //
 // This entry says that an HPA, via its
 // 'spec/scaleTargetRef/name' field, may refer to a
 // Deployment.  This match to HPA means we may need to
 // modify the value in its 'spec/scaleTargetRef/name'
 // field, by searching for the thing it refers to,
 // and getting its new name.
 //
 // As a filter, and search optimization, we compute a
 // subset of all resources that the HPA could refer to,
 // by excluding objects from other namespaces, and
 // excluding objects that don't have the same prefix-
 // suffix mods as the HPA.
 //
 // We look in this subset for all Deployment objects
 // with a resId that has a Name matching the field value
 // present in the HPA.  If no match do nothing; if more
 // than one match, it's an error.
 //
 // We overwrite the HPA name field with the value found
 // in the Deployment's name field (the name in the raw
 // object - the modified name - not the unmodified name
 // in the Deployment's resId).
 //
 // This process assumes that the name stored in a ResId
 // (the ResMap key) isn't modified by name transformers.
 // Name transformers should only modify the name in the
 // body of the resource object (the value in the ResMap).
 //
 func (o *nameReferenceTransformer) Transform(m resmap.ResMap) error {
 	// TODO: Too much looping, here and in transitive calls.
 	for _, referrer := range m.Resources() {
 		var candidates resmap.ResMap
 		for _, target := range o.backRefs {
 			for _, fSpec := range target.FieldSpecs {
 				if referrer.OrgId().IsSelected(&fSpec.Gvk) {
 					if candidates == nil {
 						candidates = m.SubsetThatCouldBeReferencedByResource(referrer)
 					}
 					err := transform.MutateField(
 						referrer.Map(),
 						fSpec.PathSlice(),
 						fSpec.CreateIfNotPresent,
 						o.getNewNameFunc(
 							// referrer could be an HPA instance,
 							// target could be Gvk for Deployment,
 							// candidate a list of resources "reachable"
 							// from the HPA.
 							referrer, target.Gvk, candidates))
 					if err != nil {
 						return err
 					}
 				}
 			}
 		}
 	}
 	return nil
 }
 // selectReferral picks the referral among a subset of candidates.
 // It returns the current name and namespace of the selected candidate.
 // Note that the content of the referricalCandidateSubset slice is most of the time
 // identical to the referralCandidates resmap. Still in some cases, such
 // as ClusterRoleBinding, the subset only contains the resources of a specific
 // namespace.
 func (o *nameReferenceTransformer) selectReferral(
 	oldName string,
 	referrer *resource.Resource,
 	target resid.Gvk,
 	referralCandidates resmap.ResMap,
 	referralCandidateSubset []*resource.Resource) (interface{}, interface{}, error) {
 	for _, res := range referralCandidateSubset {
 		id := res.OrgId()
 		if id.IsSelected(&target) && res.GetOriginalName() == oldName {
 			matches := referralCandidates.GetMatchingResourcesByOriginalId(id.Equals)
 			// If there's more than one match, there's no way
 			// to know which one to pick, so emit error.
 			if len(matches) > 1 {
 				return nil, nil, fmt.Errorf(
 					"multiple matches for %s:\n  %v",
 					id, getIds(matches))
 			}
 			// In the resource, note that it is referenced
 			// by the referrer.
 			res.AppendRefBy(referrer.CurId())
 			// Return transformed name of the object,
 			// complete with prefixes, hashes, etc.
 			return res.GetName(), res.GetNamespace(), nil
 		}
 	}
 	return oldName, nil, nil
 }
 // utility function to replace a simple string by the new name
 func (o *nameReferenceTransformer) getSimpleNameField(
 	oldName string,
 	referrer *resource.Resource,
 	target resid.Gvk,
 	referralCandidates resmap.ResMap,
 	referralCandidateSubset []*resource.Resource) (interface{}, error) {
 	newName, _, err := o.selectReferral(oldName, referrer, target,
 		referralCandidates, referralCandidateSubset)
 	return newName, err
 }
 // utility function to replace name field within a map[string]interface{}
 // and leverage the namespace field.
 func (o *nameReferenceTransformer) getNameAndNsStruct(
 	inMap map[string]interface{},
 	referrer *resource.Resource,
 	target resid.Gvk,
 	referralCandidates resmap.ResMap) (interface{}, error) {
 	// Example:
 	if _, ok := inMap["name"]; !ok {
 		return nil, fmt.Errorf(
 			"%#v is expected to contain a name field", inMap)
 	}
 	oldName, ok := inMap["name"].(string)
 	if !ok {
 		return nil, fmt.Errorf(
 			"%#v is expected to contain a name field of type string", oldName)
 	}
 	subset := referralCandidates.Resources()
 	if namespacevalue, ok := inMap["namespace"]; ok {
 		namespace := namespacevalue.(string)
 		bynamespace := referralCandidates.GroupedByOriginalNamespace()
 		if _, ok := bynamespace[namespace]; !ok {
 			return inMap, nil
 		}
 		subset = bynamespace[namespace]
 	}
 	newname, newnamespace, err := o.selectReferral(oldName, referrer, target,
 		referralCandidates, subset)
 	if err != nil {
 		return nil, err
 	}
 	if (newname == oldName) && (newnamespace == nil) {
 		// no candidate found.
 		return inMap, nil
 	}
 	inMap["name"] = newname
 	if newnamespace != "" {
 		// We don't want value "" to replace value "default" since
 		// the empty string is handled as a wild card here not default namespace
 		// by kubernetes.
 		inMap["namespace"] = newnamespace
 	}
 	return inMap, nil
 }
 func (o *nameReferenceTransformer) getNewNameFunc(
 	referrer *resource.Resource,
 	target resid.Gvk,
 	referralCandidates resmap.ResMap) func(in interface{}) (interface{}, error) {
 	return func(in interface{}) (interface{}, error) {
 		switch in.(type) {
 		case string:
 			oldName, _ := in.(string)
 			return o.getSimpleNameField(oldName, referrer, target,
 				referralCandidates, referralCandidates.Resources())
 		case map[string]interface{}:
 			// Kind: ValidatingWebhookConfiguration
 			// FieldSpec is webhooks/clientConfig/service
 			oldMap, _ := in.(map[string]interface{})
 			return o.getNameAndNsStruct(oldMap, referrer, target,
 				referralCandidates)
 		case []interface{}:
 			l, _ := in.([]interface{})
 			for idx, item := range l {
 				switch item.(type) {
 				case string:
 					// Kind: Role/ClusterRole
 					// FieldSpec is rules.resourceNames
 					oldName, _ := item.(string)
 					newName, err := o.getSimpleNameField(oldName, referrer, target,
 						referralCandidates, referralCandidates.Resources())
 					if err != nil {
 						return nil, err
 					}
 					l[idx] = newName
 				case map[string]interface{}:
 					// Kind: RoleBinding/ClusterRoleBinding
 					// FieldSpec is subjects
 					// Note: The corresponding fieldSpec had been changed from
 					// from path: subjects/name to just path: subjects. This is
 					// what get mutatefield to request the mapping of the whole
 					// map containing namespace and name instead of just a simple
 					// string field containing the name
 					oldMap, _ := item.(map[string]interface{})
 					newMap, err := o.getNameAndNsStruct(oldMap, referrer, target,
 						referralCandidates)
 					if err != nil {
 						return nil, err
 					}
 					l[idx] = newMap
 				default:
 					return nil, fmt.Errorf(
 						"%#v is expected to be either a []string or a []map[string]interface{}", in)
 				}
 			}
 			return in, nil
 		default:
 			return nil, fmt.Errorf(
 				"%#v is expected to be either a string or a []interface{}", in)
 		}
 	}
 }
 func getIds(rs []*resource.Resource) []string {
 	var result []string
 	for _, r := range rs {
 		result = append(result, r.CurId().String()+"\n")
 	}
 	return result
 }
--- a/api/internal/accumulator/namereferencetransformer_test.go
+++ b/api/internal/accumulator/namereferencetransformer_test.go
--- a/api/internal/accumulator/refvartransformer_test.go
+++ b/api/internal/accumulator/refvartransformer_test.go
@@ -1,137 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package accumulator
 import (
 	"reflect"
 	"testing"
 	"sigs.k8s.io/kustomize/api/k8sdeps/kunstruct"
 	"sigs.k8s.io/kustomize/api/resid"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	"sigs.k8s.io/kustomize/api/testutils/resmaptest"
 	"sigs.k8s.io/kustomize/api/types"
 )
 func TestRefVarTransformer(t *testing.T) {
 	type given struct {
 		varMap map[string]interface{}
 		fs     []types.FieldSpec
 		res    resmap.ResMap
 	}
 	type expected struct {
 		res    resmap.ResMap
 		unused []string
 	}
 	testCases := []struct {
 		description string
 		given       given
 		expected    expected
 	}{
 		{
 			description: "var replacement in map[string]",
 			given: given{
 				varMap: map[string]interface{}{
 					"FOO": "replacementForFoo",
 					"BAR": "replacementForBar",
 					"BAZ": int64(5),
 					"BOO": true,
 				},
 				fs: []types.FieldSpec{
 					{Gvk: resid.Gvk{Version: "v1", Kind: "ConfigMap"}, Path: "data/map"},
 					{Gvk: resid.Gvk{Version: "v1", Kind: "ConfigMap"}, Path: "data/slice"},
 					{Gvk: resid.Gvk{Version: "v1", Kind: "ConfigMap"}, Path: "data/interface"},
 					{Gvk: resid.Gvk{Version: "v1", Kind: "ConfigMap"}, Path: "data/nil"},
 					{Gvk: resid.Gvk{Version: "v1", Kind: "ConfigMap"}, Path: "data/num"},
 				},
 				res: resmaptest_test.NewRmBuilder(
 					t, resource.NewFactory(kunstruct.NewKunstructuredFactoryImpl())).
 					Add(map[string]interface{}{
 						"apiVersion": "v1",
 						"kind":       "ConfigMap",
 						"metadata": map[string]interface{}{
 							"name": "cm1",
 						},
 						"data": map[string]interface{}{
 							"map": map[string]interface{}{
 								"item1": "$(FOO)",
 								"item2": "bla",
 								"item3": "$(BAZ)",
 								"item4": "$(BAZ)+$(BAZ)",
 								"item5": "$(BOO)",
 								"item6": "if $(BOO)",
 								"item7": 2019,
 							},
 							"slice": []interface{}{
 								"$(FOO)",
 								"bla",
 								"$(BAZ)",
 								"$(BAZ)+$(BAZ)",
 								"$(BOO)",
 								"if $(BOO)",
 							},
 							"interface": "$(FOO)",
 							"nil":       nil,
 							"num":       2019,
 						}}).ResMap(),
 			},
 			expected: expected{
 				res: resmaptest_test.NewRmBuilder(
 					t, resource.NewFactory(kunstruct.NewKunstructuredFactoryImpl())).
 					Add(map[string]interface{}{
 						"apiVersion": "v1",
 						"kind":       "ConfigMap",
 						"metadata": map[string]interface{}{
 							"name": "cm1",
 						},
 						"data": map[string]interface{}{
 							"map": map[string]interface{}{
 								"item1": "replacementForFoo",
 								"item2": "bla",
 								"item3": int64(5),
 								"item4": "5+5",
 								"item5": true,
 								"item6": "if true",
 								"item7": 2019,
 							},
 							"slice": []interface{}{
 								"replacementForFoo",
 								"bla",
 								int64(5),
 								"5+5",
 								true,
 								"if true",
 							},
 							"interface": "replacementForFoo",
 							"nil":       nil,
 							"num":       2019,
 						}}).ResMap(),
 				unused: []string{"BAR"},
 			},
 		},
 	}
 	for _, tc := range testCases {
 		t.Run(tc.description, func(t *testing.T) {
 			// arrange
 			tr := newRefVarTransformer(tc.given.varMap, tc.given.fs)
 			// act
 			err := tr.Transform(tc.given.res)
 			// assert
 			if err != nil {
 				t.Errorf("unexpected error: %v", err)
 			}
 			a, e := tc.given.res, tc.expected.res
 			if !reflect.DeepEqual(a, e) {
 				err = e.ErrorIfNotEqualLists(a)
 				t.Fatalf("actual doesn't match expected: \nACTUAL:\n%v\nEXPECTED:\n%v\nERR: %v", a, e, err)
 			}
 		})
 	}
 }
--- a/api/loader/loader.go
+++ b/api/loader/loader.go
@@ -1,34 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package loader has a data loading interface and various implementations.
 package loader
 import (
 	"sigs.k8s.io/kustomize/api/filesys"
 	"sigs.k8s.io/kustomize/api/git"
 	"sigs.k8s.io/kustomize/api/ifc"
 )
 // NewLoader returns a Loader pointed at the given target.
 // If the target is remote, the loader will be restricted
 // to the root and below only.  If the target is local, the
 // loader will have the restrictions passed in.  Regardless,
 // if a local target attempts to transitively load remote bases,
 // the remote bases will all be root-only restricted.
 func NewLoader(
 	lr LoadRestrictorFunc,
 	target string, fSys filesys.FileSystem) (ifc.Loader, error) {
 	repoSpec, err := git.NewRepoSpecFromUrl(target)
 	if err == nil {
 		// The target qualifies as a remote git target.
 		return newLoaderAtGitClone(
 			repoSpec, fSys, nil, git.ClonerUsingGitExec)
 	}
 	root, err := demandDirectoryRoot(fSys, target)
 	if err != nil {
 		return nil, err
 	}
 	return newLoaderAtConfirmedDir(
 		lr, root, fSys, nil, git.ClonerUsingGitExec), nil
 }
--- a/api/main.go
+++ b/api/main.go
@@ -1,21 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // A dummy main to help with releasing the kustomize API module.
 package main
 import (
 	"fmt"
 	"os"
 	"sigs.k8s.io/kustomize/api/provenance"
 )
 // TODO: delete this when we find a better way to generate release notes.
 func main() {
 	fmt.Println(`
 This 'main' exists only to make goreleaser create release notes for the API.
 See https://github.com/goreleaser/goreleaser/issues/981
 and https://github.com/kubernetes-sigs/kustomize/tree/master/releasing`)
 	provenance.GetProvenance().Print(os.Stdout, false)
 }
--- a/api/pgmconfig/pgmconfig.go
+++ b/api/pgmconfig/pgmconfig.go
@@ -1,41 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package pgmconfig
 // RecognizedKustomizationFileNames is a list of file names
 // that kustomize recognizes.
 // To avoid ambiguity, a kustomization directory may not
 // contain more than one match to this list.
 func RecognizedKustomizationFileNames() []string {
 	return []string{
 		"kustomization.yaml",
 		"kustomization.yml",
 		"Kustomization",
 	}
 }
 func DefaultKustomizationFileName() string {
 	return RecognizedKustomizationFileNames()[0]
 }
 const (
 	// An environment variable to consult for kustomization
 	// configuration data.  See:
 	// https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
 	XdgConfigHome = "XDG_CONFIG_HOME"
 	// Use this when XdgConfigHome not defined.
 	DefaultConfigSubdir = ".config"
 	// Program name, for help, finding the XDG_CONFIG_DIR, etc.
 	ProgramName = "kustomize"
 	// TODO: delete this.  it's a copy of a const
 	// defined elsewhere but used by pluginator.
 	DomainName = "sigs.k8s.io"
 	// TODO: delete this.  its a copy of a const
 	// defined elsewhere but used by pluginator.
 	PluginRoot = "plugin"
 )
--- a/api/plugins/builtinconfig/consts/doc.go
+++ b/api/plugins/builtinconfig/consts/doc.go
@@ -1,5 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package consts provides builtin plugin configuration data.
 package consts
--- a/api/plugins/builtinconfig/consts/images.go
+++ b/api/plugins/builtinconfig/consts/images.go
@@ -1,10 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package consts
 const (
 	// imageFieldSpecs is left empty since `containers` and `initContainers`
 	// of *ANY* kind in *ANY* path are builtin supported in code
 	imagesFieldSpecs = ``
 )
--- a/api/plugins/builtinconfig/consts/nameprefix.go
+++ b/api/plugins/builtinconfig/consts/nameprefix.go
@@ -1,11 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package consts
 const (
 	namePrefixFieldSpecs = `
 namePrefix:
 - path: metadata/name
 `
 )
--- a/api/plugins/builtinconfig/consts/namespace.go
+++ b/api/plugins/builtinconfig/consts/namespace.go
@@ -1,16 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package consts
 const (
 	namespaceFieldSpecs = `
 namespace:
 - path: metadata/namespace
  create: true
 - path: subjects
  kind: RoleBinding
 - path: subjects
  kind: ClusterRoleBinding
 `
 )
--- a/api/plugins/builtinconfig/doc.go
+++ b/api/plugins/builtinconfig/doc.go
@@ -1,10 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package builtinconfig provides legacy methods for
 // configuring builtin plugins from a common config file.
 // As a user, its best to configure plugins individually
 // with plugin config files specified in the `transformers:`
 // or `generators:` field, than to use this legacy
 // configuration technique.
 package builtinconfig
--- a/api/plugins/builtinconfig/loaddefaultconfig.go
+++ b/api/plugins/builtinconfig/loaddefaultconfig.go
@@ -1,42 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package builtinconfig
 import (
 	"sigs.k8s.io/kustomize/api/ifc"
 	"sigs.k8s.io/yaml"
 )
 // loadDefaultConfig returns a TranformerConfig
 // object from a list of files.
 func loadDefaultConfig(
 	ldr ifc.Loader, paths []string) (*TransformerConfig, error) {
 	result := &TransformerConfig{}
 	for _, path := range paths {
 		data, err := ldr.Load(path)
 		if err != nil {
 			return nil, err
 		}
 		t, err := makeTransformerConfigFromBytes(data)
 		if err != nil {
 			return nil, err
 		}
 		result, err = result.Merge(t)
 		if err != nil {
 			return nil, err
 		}
 	}
 	return result, nil
 }
 // makeTransformerConfigFromBytes returns a TransformerConfig object from bytes
 func makeTransformerConfigFromBytes(data []byte) (*TransformerConfig, error) {
 	var t TransformerConfig
 	err := yaml.Unmarshal(data, &t)
 	if err != nil {
 		return nil, err
 	}
 	t.sortFields()
 	return &t, nil
 }
--- a/api/plugins/builtinconfig/transformerconfig.go
+++ b/api/plugins/builtinconfig/transformerconfig.go
@@ -1,148 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package builtinconfig
 import (
 	"log"
 	"sort"
 	"sigs.k8s.io/kustomize/api/ifc"
 	"sigs.k8s.io/kustomize/api/plugins/builtinconfig/consts"
 	"sigs.k8s.io/kustomize/api/types"
 )
 // TransformerConfig holds the data needed to perform transformations.
 type TransformerConfig struct {
 	NamePrefix        types.FsSlice `json:"namePrefix,omitempty" yaml:"namePrefix,omitempty"`
 	NameSuffix        types.FsSlice `json:"nameSuffix,omitempty" yaml:"nameSuffix,omitempty"`
 	NameSpace         types.FsSlice `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 	CommonLabels      types.FsSlice `json:"commonLabels,omitempty" yaml:"commonLabels,omitempty"`
 	CommonAnnotations types.FsSlice `json:"commonAnnotations,omitempty" yaml:"commonAnnotations,omitempty"`
 	NameReference     nbrSlice      `json:"nameReference,omitempty" yaml:"nameReference,omitempty"`
 	VarReference      types.FsSlice `json:"varReference,omitempty" yaml:"varReference,omitempty"`
 	Images            types.FsSlice `json:"images,omitempty" yaml:"images,omitempty"`
 	Replicas          types.FsSlice `json:"replicas,omitempty" yaml:"replicas,omitempty"`
 }
 // MakeEmptyConfig returns an empty TransformerConfig object
 func MakeEmptyConfig() *TransformerConfig {
 	return &TransformerConfig{}
 }
 // MakeDefaultConfig returns a default TransformerConfig.
 func MakeDefaultConfig() *TransformerConfig {
 	c, err := makeTransformerConfigFromBytes(
 		consts.GetDefaultFieldSpecs())
 	if err != nil {
 		log.Fatalf("Unable to make default transformconfig: %v", err)
 	}
 	return c
 }
 // MakeTransformerConfig returns a merger of custom config,
 // if any, with default config.
 func MakeTransformerConfig(
 	ldr ifc.Loader, paths []string) (*TransformerConfig, error) {
 	t1 := MakeDefaultConfig()
 	if len(paths) == 0 {
 		return t1, nil
 	}
 	t2, err := loadDefaultConfig(ldr, paths)
 	if err != nil {
 		return nil, err
 	}
 	return t1.Merge(t2)
 }
 // sortFields provides determinism in logging, tests, etc.
 func (t *TransformerConfig) sortFields() {
 	sort.Sort(t.NamePrefix)
 	sort.Sort(t.NameSpace)
 	sort.Sort(t.CommonLabels)
 	sort.Sort(t.CommonAnnotations)
 	sort.Sort(t.NameReference)
 	sort.Sort(t.VarReference)
 	sort.Sort(t.Images)
 	sort.Sort(t.Replicas)
 }
 // AddPrefixFieldSpec adds a FieldSpec to NamePrefix
 func (t *TransformerConfig) AddPrefixFieldSpec(fs types.FieldSpec) (err error) {
 	t.NamePrefix, err = t.NamePrefix.MergeOne(fs)
 	return err
 }
 // AddSuffixFieldSpec adds a FieldSpec to NameSuffix
 func (t *TransformerConfig) AddSuffixFieldSpec(fs types.FieldSpec) (err error) {
 	t.NameSuffix, err = t.NameSuffix.MergeOne(fs)
 	return err
 }
 // AddLabelFieldSpec adds a FieldSpec to CommonLabels
 func (t *TransformerConfig) AddLabelFieldSpec(fs types.FieldSpec) (err error) {
 	t.CommonLabels, err = t.CommonLabels.MergeOne(fs)
 	return err
 }
 // AddAnnotationFieldSpec adds a FieldSpec to CommonAnnotations
 func (t *TransformerConfig) AddAnnotationFieldSpec(fs types.FieldSpec) (err error) {
 	t.CommonAnnotations, err = t.CommonAnnotations.MergeOne(fs)
 	return err
 }
 // AddNamereferenceFieldSpec adds a NameBackReferences to NameReference
 func (t *TransformerConfig) AddNamereferenceFieldSpec(
 	nbrs NameBackReferences) (err error) {
 	t.NameReference, err = t.NameReference.mergeOne(nbrs)
 	return err
 }
 // Merge merges two TransformerConfigs objects into
 // a new TransformerConfig object
 func (t *TransformerConfig) Merge(input *TransformerConfig) (
 	merged *TransformerConfig, err error) {
 	if input == nil {
 		return t, nil
 	}
 	merged = &TransformerConfig{}
 	merged.NamePrefix, err = t.NamePrefix.MergeAll(input.NamePrefix)
 	if err != nil {
 		return nil, err
 	}
 	merged.NameSuffix, err = t.NameSuffix.MergeAll(input.NameSuffix)
 	if err != nil {
 		return nil, err
 	}
 	merged.NameSpace, err = t.NameSpace.MergeAll(input.NameSpace)
 	if err != nil {
 		return nil, err
 	}
 	merged.CommonAnnotations, err = t.CommonAnnotations.MergeAll(
 		input.CommonAnnotations)
 	if err != nil {
 		return nil, err
 	}
 	merged.CommonLabels, err = t.CommonLabels.MergeAll(input.CommonLabels)
 	if err != nil {
 		return nil, err
 	}
 	merged.VarReference, err = t.VarReference.MergeAll(input.VarReference)
 	if err != nil {
 		return nil, err
 	}
 	merged.NameReference, err = t.NameReference.mergeAll(input.NameReference)
 	if err != nil {
 		return nil, err
 	}
 	merged.Images, err = t.Images.MergeAll(input.Images)
 	if err != nil {
 		return nil, err
 	}
 	merged.Replicas, err = t.Replicas.MergeAll(input.Replicas)
 	if err != nil {
 		return nil, err
 	}
 	merged.sortFields()
 	return merged, nil
 }
--- a/api/plugins/builtinhelpers/builtinplugintype_string.go
+++ b/api/plugins/builtinhelpers/builtinplugintype_string.go
@@ -1,37 +0,0 @@
 // Code generated by "stringer -type=BuiltinPluginType"; DO NOT EDIT.
 package builtinhelpers
 import "strconv"
 func _() {
 	// An "invalid array index" compiler error signifies that the constant values have changed.
 	// Re-run the stringer command to generate them again.
 	var x [1]struct{}
 	_ = x[Unknown-0]
 	_ = x[AnnotationsTransformer-1]
 	_ = x[ConfigMapGenerator-2]
 	_ = x[HashTransformer-3]
 	_ = x[ImageTagTransformer-4]
 	_ = x[InventoryTransformer-5]
 	_ = x[LabelTransformer-6]
 	_ = x[LegacyOrderTransformer-7]
 	_ = x[NamespaceTransformer-8]
 	_ = x[PatchJson6902Transformer-9]
 	_ = x[PatchStrategicMergeTransformer-10]
 	_ = x[PatchTransformer-11]
 	_ = x[PrefixSuffixTransformer-12]
 	_ = x[ReplicaCountTransformer-13]
 	_ = x[SecretGenerator-14]
 }
 const _BuiltinPluginType_name = "UnknownAnnotationsTransformerConfigMapGeneratorHashTransformerImageTagTransformerInventoryTransformerLabelTransformerLegacyOrderTransformerNamespaceTransformerPatchJson6902TransformerPatchStrategicMergeTransformerPatchTransformerPrefixSuffixTransformerReplicaCountTransformerSecretGenerator"
 var _BuiltinPluginType_index = [...]uint16{0, 7, 29, 47, 62, 81, 101, 117, 139, 159, 183, 213, 229, 252, 275, 290}
 func (i BuiltinPluginType) String() string {
 	if i < 0 || i >= BuiltinPluginType(len(_BuiltinPluginType_index)-1) {
 		return "BuiltinPluginType(" + strconv.FormatInt(int64(i), 10) + ")"
 	}
 	return _BuiltinPluginType_name[_BuiltinPluginType_index[i]:_BuiltinPluginType_index[i+1]]
 }
--- a/api/plugins/builtinhelpers/builtins.go
+++ b/api/plugins/builtinhelpers/builtins.go
@@ -1,75 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package builtinhelpers
 import (
 	"sigs.k8s.io/kustomize/api/plugins/builtins"
 	"sigs.k8s.io/kustomize/api/resmap"
 )
 //go:generate stringer -type=BuiltinPluginType
 type BuiltinPluginType int
 const (
 	Unknown BuiltinPluginType = iota
 	AnnotationsTransformer
 	ConfigMapGenerator
 	HashTransformer
 	ImageTagTransformer
 	InventoryTransformer
 	LabelTransformer
 	LegacyOrderTransformer
 	NamespaceTransformer
 	PatchJson6902Transformer
 	PatchStrategicMergeTransformer
 	PatchTransformer
 	PrefixSuffixTransformer
 	ReplicaCountTransformer
 	SecretGenerator
 )
 var stringToBuiltinPluginTypeMap map[string]BuiltinPluginType
 func init() {
 	stringToBuiltinPluginTypeMap = makeStringToBuiltinPluginTypeMap()
 }
 func makeStringToBuiltinPluginTypeMap() (result map[string]BuiltinPluginType) {
 	result = make(map[string]BuiltinPluginType, 23)
 	for k := range GeneratorFactories {
 		result[k.String()] = k
 	}
 	for k := range TransformerFactories {
 		result[k.String()] = k
 	}
 	return
 }
 func GetBuiltinPluginType(n string) BuiltinPluginType {
 	result, ok := stringToBuiltinPluginTypeMap[n]
 	if ok {
 		return result
 	}
 	return Unknown
 }
 var GeneratorFactories = map[BuiltinPluginType]func() resmap.GeneratorPlugin{
 	ConfigMapGenerator: builtins.NewConfigMapGeneratorPlugin,
 	SecretGenerator:    builtins.NewSecretGeneratorPlugin,
 }
 var TransformerFactories = map[BuiltinPluginType]func() resmap.TransformerPlugin{
 	AnnotationsTransformer:         builtins.NewAnnotationsTransformerPlugin,
 	HashTransformer:                builtins.NewHashTransformerPlugin,
 	ImageTagTransformer:            builtins.NewImageTagTransformerPlugin,
 	InventoryTransformer:           builtins.NewInventoryTransformerPlugin,
 	LabelTransformer:               builtins.NewLabelTransformerPlugin,
 	LegacyOrderTransformer:         builtins.NewLegacyOrderTransformerPlugin,
 	NamespaceTransformer:           builtins.NewNamespaceTransformerPlugin,
 	PatchJson6902Transformer:       builtins.NewPatchJson6902TransformerPlugin,
 	PatchStrategicMergeTransformer: builtins.NewPatchStrategicMergeTransformerPlugin,
 	PatchTransformer:               builtins.NewPatchTransformerPlugin,
 	PrefixSuffixTransformer:        builtins.NewPrefixSuffixTransformerPlugin,
 	ReplicaCountTransformer:        builtins.NewReplicaCountTransformerPlugin,
 }
--- a/api/plugins/builtins/AnnotationsTransformer.go
+++ b/api/plugins/builtins/AnnotationsTransformer.go
@@ -1,42 +0,0 @@
 // Code generated by pluginator on AnnotationsTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/transform"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/yaml"
 )
 // Add the given annotations to the given field specifications.
 type AnnotationsTransformerPlugin struct {
 	Annotations map[string]string `json:"annotations,omitempty" yaml:"annotations,omitempty"`
 	FieldSpecs  []types.FieldSpec `json:"fieldSpecs,omitempty" yaml:"fieldSpecs,omitempty"`
 }
 func (p *AnnotationsTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	p.Annotations = nil
 	p.FieldSpecs = nil
 	return yaml.Unmarshal(c, p)
 }
 func (p *AnnotationsTransformerPlugin) Transform(m resmap.ResMap) error {
 	t, err := transform.NewMapTransformer(
 		p.FieldSpecs,
 		p.Annotations,
 	)
 	if err != nil {
 		return err
 	}
 	return t.Transform(m)
 }
 func NewAnnotationsTransformerPlugin() resmap.TransformerPlugin {
  return &AnnotationsTransformerPlugin{}
 }
--- a/api/plugins/builtins/LabelTransformer.go
+++ b/api/plugins/builtins/LabelTransformer.go
@@ -1,42 +0,0 @@
 // Code generated by pluginator on LabelTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/transform"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/yaml"
 )
 // Add the given labels to the given field specifications.
 type LabelTransformerPlugin struct {
 	Labels     map[string]string `json:"labels,omitempty" yaml:"labels,omitempty"`
 	FieldSpecs []types.FieldSpec `json:"fieldSpecs,omitempty" yaml:"fieldSpecs,omitempty"`
 }
 func (p *LabelTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	p.Labels = nil
 	p.FieldSpecs = nil
 	return yaml.Unmarshal(c, p)
 }
 func (p *LabelTransformerPlugin) Transform(m resmap.ResMap) error {
 	t, err := transform.NewMapTransformer(
 		p.FieldSpecs,
 		p.Labels,
 	)
 	if err != nil {
 		return err
 	}
 	return t.Transform(m)
 }
 func NewLabelTransformerPlugin() resmap.TransformerPlugin {
  return &LabelTransformerPlugin{}
 }
--- a/api/plugins/builtins/NamespaceTransformer.go
+++ b/api/plugins/builtins/NamespaceTransformer.go
@@ -1,134 +0,0 @@
 // Code generated by pluginator on NamespaceTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"fmt"
 	"sigs.k8s.io/kustomize/api/transform"
 	"sigs.k8s.io/kustomize/api/resid"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/yaml"
 )
 // Change or set the namespace of non-cluster level resources.
 type NamespaceTransformerPlugin struct {
 	types.ObjectMeta `json:"metadata,omitempty" yaml:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"`
 	FieldSpecs       []types.FieldSpec `json:"fieldSpecs,omitempty" yaml:"fieldSpecs,omitempty"`
 }
 func (p *NamespaceTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	p.Namespace = ""
 	p.FieldSpecs = nil
 	return yaml.Unmarshal(c, p)
 }
 func (p *NamespaceTransformerPlugin) Transform(m resmap.ResMap) error {
 	if len(p.Namespace) == 0 {
 		return nil
 	}
 	for _, r := range m.Resources() {
 		if len(r.Map()) == 0 {
 			// Don't mutate empty objects?
 			continue
 		}
 		id := r.OrgId()
 		applicableFs := p.applicableFieldSpecs(id)
 		for _, fs := range applicableFs {
 			err := transform.MutateField(
 				r.Map(), fs.PathSlice(), fs.CreateIfNotPresent,
 				p.changeNamespace(r))
 			if err != nil {
 				return err
 			}
 		}
 		matches := m.GetMatchingResourcesByCurrentId(r.CurId().Equals)
 		if len(matches) != 1 {
 			return fmt.Errorf("namespace tranformation produces ID conflict: %#v", matches)
 		}
 	}
 	return nil
 }
 const metaNamespace = "metadata/namespace"
 // Special casing metadata.namespace since
 // all objects have it, even "ClusterKind" objects
 // that don't exist in a namespace (the Namespace
 // object itself doesn't live in a namespace).
 func (p *NamespaceTransformerPlugin) applicableFieldSpecs(id resid.ResId) []types.FieldSpec {
 	var res []types.FieldSpec
 	for _, fs := range p.FieldSpecs {
 		if id.IsSelected(&fs.Gvk) && (fs.Path != metaNamespace || (fs.Path == metaNamespace && id.IsNamespaceableKind())) {
 			res = append(res, fs)
 		}
 	}
 	return res
 }
 func (p *NamespaceTransformerPlugin) changeNamespace(
 	referrer *resource.Resource) func(in interface{}) (interface{}, error) {
 	return func(in interface{}) (interface{}, error) {
 		switch in.(type) {
 		case string:
 			// will happen when the metadata/namespace
 			// value is replaced
 			return p.Namespace, nil
 		case []interface{}:
 			l, _ := in.([]interface{})
 			for idx, item := range l {
 				switch item.(type) {
 				case map[string]interface{}:
 					// Will happen when mutating the subjects
 					// field of ClusterRoleBinding and RoleBinding
 					inMap, _ := item.(map[string]interface{})
 					if _, ok := inMap["name"]; !ok {
 						continue
 					}
 					name, ok := inMap["name"].(string)
 					if !ok {
 						continue
 					}
 					// The only case we need to force the namespace
 					// if for the "service account". "default" is
 					// kind of hardcoded here for right now.
 					if name != "default" {
 						continue
 					}
 					inMap["namespace"] = p.Namespace
 					l[idx] = inMap
 				default:
 					// nothing to do for right now
 				}
 			}
 			return in, nil
 		case map[string]interface{}:
 			// Will happen if the createField=true
 			// when the namespace is added to the
 			// object
 			inMap := in.(map[string]interface{})
 			if len(inMap) == 0 {
 				return p.Namespace, nil
 			} else {
 				return in, nil
 			}
 		default:
 			return in, nil
 		}
 	}
 }
 func NewNamespaceTransformerPlugin() resmap.TransformerPlugin {
  return &NamespaceTransformerPlugin{}
 }
--- a/api/plugins/builtins/PatchStrategicMergeTransformer.go
+++ b/api/plugins/builtins/PatchStrategicMergeTransformer.go
@@ -1,93 +0,0 @@
 // Code generated by pluginator on PatchStrategicMergeTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"fmt"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/yaml"
 )
 type PatchStrategicMergeTransformerPlugin struct {
 	h             *resmap.PluginHelpers
 	loadedPatches []*resource.Resource
 	Paths         []types.PatchStrategicMerge `json:"paths,omitempty" yaml:"paths,omitempty"`
 	Patches       string                      `json:"patches,omitempty" yaml:"patches,omitempty"`
 }
 func (p *PatchStrategicMergeTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	p.h = h
 	err = yaml.Unmarshal(c, p)
 	if err != nil {
 		return err
 	}
 	if len(p.Paths) == 0 && p.Patches == "" {
 		return fmt.Errorf("empty file path and empty patch content")
 	}
 	if len(p.Paths) != 0 {
 		for _, onePath := range p.Paths {
 			res, err := p.h.ResmapFactory().RF().SliceFromBytes([]byte(onePath))
 			if err == nil {
 				p.loadedPatches = append(p.loadedPatches, res...)
 				continue
 			}
 			res, err = p.h.ResmapFactory().RF().SliceFromPatches(
 				p.h.Loader(), []types.PatchStrategicMerge{onePath})
 			if err != nil {
 				return err
 			}
 			p.loadedPatches = append(p.loadedPatches, res...)
 		}
 	}
 	if p.Patches != "" {
 		res, err := p.h.ResmapFactory().RF().SliceFromBytes([]byte(p.Patches))
 		if err != nil {
 			return err
 		}
 		p.loadedPatches = append(p.loadedPatches, res...)
 	}
 	if len(p.loadedPatches) == 0 {
 		return fmt.Errorf(
 			"patch appears to be empty; files=%v, Patch=%s", p.Paths, p.Patches)
 	}
 	return err
 }
 func (p *PatchStrategicMergeTransformerPlugin) Transform(m resmap.ResMap) error {
 	patches, err := p.h.ResmapFactory().MergePatches(p.loadedPatches)
 	if err != nil {
 		return err
 	}
 	for _, patch := range patches.Resources() {
 		target, err := m.GetById(patch.OrgId())
 		if err != nil {
 			return err
 		}
 		err = target.Patch(patch.Kunstructured)
 		if err != nil {
 			return err
 		}
 		// remove the resource from resmap
 		// when the patch is to $patch: delete that target
 		if len(target.Map()) == 0 {
 			err = m.Remove(target.CurId())
 			if err != nil {
 				return err
 			}
 		}
 	}
 	return nil
 }
 func NewPatchStrategicMergeTransformerPlugin() resmap.TransformerPlugin {
  return &PatchStrategicMergeTransformerPlugin{}
 }
--- a/api/plugins/builtins/PatchTransformer.go
+++ b/api/plugins/builtins/PatchTransformer.go
@@ -1,148 +0,0 @@
 // Code generated by pluginator on PatchTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"fmt"
 	"github.com/evanphx/json-patch"
 	"github.com/pkg/errors"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/yaml"
 )
 type PatchTransformerPlugin struct {
 	loadedPatch  *resource.Resource
 	decodedPatch jsonpatch.Patch
 	Path         string          `json:"path,omitempty" yaml:"path,omitempty"`
 	Patch        string          `json:"patch,omitempty" yaml:"patch,omitempty"`
 	Target       *types.Selector `json:"target,omitempty" yaml:"target,omitempty"`
 }
 func (p *PatchTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	err = yaml.Unmarshal(c, p)
 	if err != nil {
 		return err
 	}
 	if p.Patch == "" && p.Path == "" {
 		err = fmt.Errorf(
 			"must specify one of patch and path in\n%s", string(c))
 		return
 	}
 	if p.Patch != "" && p.Path != "" {
 		err = fmt.Errorf(
 			"patch and path can't be set at the same time\n%s", string(c))
 		return
 	}
 	var in []byte
 	if p.Path != "" {
 		in, err = h.Loader().Load(p.Path)
 		if err != nil {
 			return
 		}
 	}
 	if p.Patch != "" {
 		in = []byte(p.Patch)
 	}
 	patchSM, errSM := h.ResmapFactory().RF().FromBytes(in)
 	patchJson, errJson := jsonPatchFromBytes(in)
 	if errSM != nil && errJson != nil {
 		err = fmt.Errorf(
 			"unable to get either a Strategic Merge Patch or JSON patch 6902 from %s", p.Patch)
 		return
 	}
 	if errSM == nil && errJson != nil {
 		p.loadedPatch = patchSM
 	}
 	if errJson == nil && errSM != nil {
 		p.decodedPatch = patchJson
 	}
 	if patchSM != nil && patchJson != nil {
 		err = fmt.Errorf(
 			"a patch can't be both a Strategic Merge Patch and JSON patch 6902 %s", p.Patch)
 	}
 	return nil
 }
 func (p *PatchTransformerPlugin) Transform(m resmap.ResMap) error {
 	if p.loadedPatch != nil && p.Target == nil {
 		target, err := m.GetById(p.loadedPatch.OrgId())
 		if err != nil {
 			return err
 		}
 		err = target.Patch(p.loadedPatch.Kunstructured)
 		if err != nil {
 			return err
 		}
 		return nil
 	}
 	if p.Target == nil {
 		return fmt.Errorf("must specify a target for patch %s", p.Patch)
 	}
 	resources, err := m.Select(*p.Target)
 	if err != nil {
 		return err
 	}
 	for _, res := range resources {
 		if p.decodedPatch != nil {
 			rawObj, err := res.MarshalJSON()
 			if err != nil {
 				return err
 			}
 			modifiedObj, err := p.decodedPatch.Apply(rawObj)
 			if err != nil {
 				return errors.Wrapf(
 					err, "failed to apply json patch '%s'", p.Patch)
 			}
 			err = res.UnmarshalJSON(modifiedObj)
 			if err != nil {
 				return err
 			}
 		}
 		if p.loadedPatch != nil {
 			patchCopy := p.loadedPatch.DeepCopy()
 			patchCopy.SetName(res.GetName())
 			patchCopy.SetNamespace(res.GetNamespace())
 			patchCopy.SetGvk(res.GetGvk())
 			err = res.Patch(patchCopy.Kunstructured)
 			if err != nil {
 				return err
 			}
 		}
 	}
 	return nil
 }
 // jsonPatchFromBytes loads a Json 6902 patch from
 // a bytes input
 func jsonPatchFromBytes(
 	in []byte) (jsonpatch.Patch, error) {
 	ops := string(in)
 	if ops == "" {
 		return nil, fmt.Errorf("empty json patch operations")
 	}
 	if ops[0] != '[' {
 		jsonOps, err := yaml.YAMLToJSON(in)
 		if err != nil {
 			return nil, err
 		}
 		ops = string(jsonOps)
 	}
 	return jsonpatch.DecodePatch([]byte(ops))
 }
 func NewPatchTransformerPlugin() resmap.TransformerPlugin {
  return &PatchTransformerPlugin{}
 }
--- a/api/plugins/builtins/PrefixSuffixTransformer.go
+++ b/api/plugins/builtins/PrefixSuffixTransformer.go
@@ -1,126 +0,0 @@
 // Code generated by pluginator on PrefixSuffixTransformer; DO NOT EDIT.
 // pluginator {Version:unknown GitCommit:$Format:%H$ BuildDate:1970-01-01T00:00:00Z GoOs:linux GoArch:amd64}
 package builtins
 import (
 	"errors"
 	"fmt"
 	"sigs.k8s.io/kustomize/api/transform"
 	"sigs.k8s.io/kustomize/api/types"
 	"sigs.k8s.io/kustomize/api/resid"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/yaml"
 )
 // Add the given prefix and suffix to the field.
 type PrefixSuffixTransformerPlugin struct {
 	Prefix     string            `json:"prefix,omitempty" yaml:"prefix,omitempty"`
 	Suffix     string            `json:"suffix,omitempty" yaml:"suffix,omitempty"`
 	FieldSpecs []types.FieldSpec `json:"fieldSpecs,omitempty" yaml:"fieldSpecs,omitempty"`
 }
 // Not placed in a file yet due to lack of demand.
 var prefixSuffixFieldSpecsToSkip = []types.FieldSpec{
 	{
 		Gvk: resid.Gvk{Kind: "CustomResourceDefinition"},
 	},
 	{
 		Gvk: resid.Gvk{Group: "apiregistration.k8s.io", Kind: "APIService"},
 	},
 }
 func (p *PrefixSuffixTransformerPlugin) Config(
 	h *resmap.PluginHelpers, c []byte) (err error) {
 	p.Prefix = ""
 	p.Suffix = ""
 	p.FieldSpecs = nil
 	err = yaml.Unmarshal(c, p)
 	if err != nil {
 		return
 	}
 	if p.FieldSpecs == nil {
 		return errors.New("fieldSpecs is not expected to be nil")
 	}
 	return
 }
 func (p *PrefixSuffixTransformerPlugin) Transform(m resmap.ResMap) error {
 	// Even if both the Prefix and Suffix are empty we want
 	// to proceed with the transformation. This allows to add contextual
 	// information to the resources (AddNamePrefix and AddNameSuffix).
 	for _, r := range m.Resources() {
 		if p.shouldSkip(r.OrgId()) {
 			// Don't change the actual definition
 			// of a CRD.
 			continue
 		}
 		id := r.OrgId()
 		// current default configuration contains
 		// only one entry: "metadata/name" with no GVK
 		for _, path := range p.FieldSpecs {
 			if !id.IsSelected(&path.Gvk) {
 				// With the currrent default configuration,
 				// because no Gvk is specified, so a wild
 				// card
 				continue
 			}
 			if smellsLikeANameChange(&path) {
 				// "metadata/name" is the only field.
 				// this will add a prefix and a suffix
 				// to the resource even if those are
 				// empty
 				r.AddNamePrefix(p.Prefix)
 				r.AddNameSuffix(p.Suffix)
 			}
 			// the addPrefixSuffix method will not
 			// change the name if both the prefix and suffix
 			// are empty.
 			err := transform.MutateField(
 				r.Map(),
 				path.PathSlice(),
 				path.CreateIfNotPresent,
 				p.addPrefixSuffix)
 			if err != nil {
 				return err
 			}
 		}
 	}
 	return nil
 }
 func smellsLikeANameChange(fs *types.FieldSpec) bool {
 	return fs.Path == "metadata/name"
 }
 func (p *PrefixSuffixTransformerPlugin) shouldSkip(
 	id resid.ResId) bool {
 	for _, path := range prefixSuffixFieldSpecsToSkip {
 		if id.IsSelected(&path.Gvk) {
 			return true
 		}
 	}
 	return false
 }
 func (p *PrefixSuffixTransformerPlugin) addPrefixSuffix(
 	in interface{}) (interface{}, error) {
 	s, ok := in.(string)
 	if !ok {
 		return nil, fmt.Errorf("%#v is expected to be %T", in, s)
 	}
 	return fmt.Sprintf("%s%s%s", p.Prefix, s, p.Suffix), nil
 }
 func NewPrefixSuffixTransformerPlugin() resmap.TransformerPlugin {
  return &PrefixSuffixTransformerPlugin{}
 }
--- a/api/plugins/builtins/doc.go
+++ b/api/plugins/builtins/doc.go
@@ -1,8 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package builtins holds code generated from the builtin plugins.
 // The "builtin" plugins are written as normal plugins and can
 // be used as such, but they are also used to generate the code
 // in this package so they can be statically linked to client code.
 package builtins
--- a/api/plugins/builtins/tools.go
+++ b/api/plugins/builtins/tools.go
@@ -1,17 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // +build tools
 // This file exists to declare that its containing
 // package explicitly depends on the pluginator
 // tool (via go:generate directives)
 package builtins
 // TODO: replace this, with the appropriate version
 // once the API is launched, and the new pluginator
 // has been compiled against it and released.
 //
 //  import (
 //  	_ "sigs.k8s.io/kustomize/pluginator"
 // )
--- a/api/plugins/config/config.go
+++ b/api/plugins/config/config.go
@@ -1,97 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package config provides configuration methods and constants
 // for general plugins.
 package config
 import (
 	"fmt"
 	"os"
 	"path/filepath"
 	"runtime"
 	"github.com/spf13/pflag"
 	"sigs.k8s.io/kustomize/api/pgmconfig"
 	"sigs.k8s.io/kustomize/api/types"
 )
 const (
 	// Used with Go plugins.
 	PluginSymbol = "KustomizePlugin"
 	// Location of builtins.
 	BuiltinPluginPackage = "builtin"
 	// ApiVersion of builtins.
 	BuiltinPluginApiVersion = BuiltinPluginPackage
 	// Domain from which kustomize code is imported, for locating
 	// plugin source code under $GOPATH.
 	DomainName = "sigs.k8s.io"
 	// Name of directory housing all plugins.
 	PluginRoot = "plugin"
 	flagEnablePluginsName = "enable_alpha_plugins"
 	flagEnablePluginsHelp = `enable plugins, an alpha feature.
 See https://github.com/kubernetes-sigs/kustomize/blob/master/docs/plugins/README.md
 `
 	flagErrorFmt = `
 unable to load external plugin %s because plugins disabled
 specify the flag
  --%s
 to %s`
 )
 func ActivePluginConfig() *types.PluginConfig {
 	pc := DefaultPluginConfig()
 	pc.Enabled = true
 	return pc
 }
 func DefaultPluginConfig() *types.PluginConfig {
 	return &types.PluginConfig{
 		Enabled:       false,
 		DirectoryPath: filepath.Join(configRoot(), PluginRoot),
 	}
 }
 func NotEnabledErr(name string) error {
 	return fmt.Errorf(
 		flagErrorFmt,
 		name,
 		flagEnablePluginsName,
 		flagEnablePluginsHelp)
 }
 func AddFlagEnablePlugins(set *pflag.FlagSet, v *bool) {
 	set.BoolVar(
 		v, flagEnablePluginsName,
 		false, flagEnablePluginsHelp)
 }
 // Use https://github.com/kirsle/configdir instead?
 func configRoot() string {
 	dir := os.Getenv(pgmconfig.XdgConfigHome)
 	if len(dir) == 0 {
 		dir = filepath.Join(
 			HomeDir(), pgmconfig.DefaultConfigSubdir)
 	}
 	return filepath.Join(dir, pgmconfig.ProgramName)
 }
 func HomeDir() string {
 	home := os.Getenv(homeEnv())
 	if len(home) > 0 {
 		return home
 	}
 	return "~"
 }
 func homeEnv() string {
 	if runtime.GOOS == "windows" {
 		return "USERPROFILE"
 	}
 	return "HOME"
 }
--- a/api/plugins/config/config_test.go
+++ b/api/plugins/config/config_test.go
@@ -1,45 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package config
 import (
 	"os"
 	"path/filepath"
 	"strings"
 	"testing"
 	"sigs.k8s.io/kustomize/api/pgmconfig"
 )
 func TestConfigDirNoXdg(t *testing.T) {
 	xdg, isSet := os.LookupEnv(pgmconfig.XdgConfigHome)
 	if isSet {
 		os.Unsetenv(pgmconfig.XdgConfigHome)
 	}
 	s := configRoot()
 	if isSet {
 		os.Setenv(pgmconfig.XdgConfigHome, xdg)
 	}
 	if !strings.HasSuffix(
 		s,
 		rootedPath(pgmconfig.DefaultConfigSubdir, pgmconfig.ProgramName)) {
 		t.Fatalf("unexpected config dir: %s", s)
 	}
 }
 func rootedPath(elem ...string) string {
 	return string(filepath.Separator) + filepath.Join(elem...)
 }
 func TestConfigDirWithXdg(t *testing.T) {
 	xdg, isSet := os.LookupEnv(pgmconfig.XdgConfigHome)
 	os.Setenv(pgmconfig.XdgConfigHome, rootedPath("blah"))
 	s := configRoot()
 	if isSet {
 		os.Setenv(pgmconfig.XdgConfigHome, xdg)
 	}
 	if s != rootedPath("blah", pgmconfig.ProgramName) {
 		t.Fatalf("unexpected config dir: %s", s)
 	}
 }
--- a/api/plugins/execplugin/execplugin_test.go
+++ b/api/plugins/execplugin/execplugin_test.go
@@ -1,189 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package execplugin_test
 import (
 	"fmt"
 	"os"
 	"strings"
 	"testing"
 	"sigs.k8s.io/kustomize/api/internal/loadertest"
 	"sigs.k8s.io/kustomize/api/k8sdeps/kunstruct"
 	"sigs.k8s.io/kustomize/api/plugins/config"
 	. "sigs.k8s.io/kustomize/api/plugins/execplugin"
 	"sigs.k8s.io/kustomize/api/plugins/loader"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/resource"
 	valtest_test "sigs.k8s.io/kustomize/api/testutils/valtest"
 	"sigs.k8s.io/kustomize/api/types"
 )
 func TestExecPluginConfig(t *testing.T) {
 	path := "/app"
 	rf := resmap.NewFactory(
 		resource.NewFactory(
 			kunstruct.NewKunstructuredFactoryImpl()), nil)
 	ldr := loadertest.NewFakeLoader(path)
 	v := valtest_test.MakeFakeValidator()
 	pluginConfig := rf.RF().FromMap(
 		map[string]interface{}{
 			"apiVersion": "someteam.example.com/v1",
 			"kind":       "SedTransformer",
 			"metadata": map[string]interface{}{
 				"name": "some-random-name",
 			},
 			"argsOneLiner": "one two",
 			"argsFromFile": "sed-input.txt",
 		})
 	ldr.AddFile("/app/sed-input.txt", []byte(`
 s/$FOO/foo/g
 s/$BAR/bar/g
 \ \ \ 
 `))
 	p, err := NewExecPlugin(
 		loader.AbsolutePluginPath(
 			config.DefaultPluginConfig(),
 			pluginConfig.OrgId()))
 	if err != nil {
 		t.Fatalf("unexpected error: %v", err.Error())
 	}
 	yaml, err := pluginConfig.AsYAML()
 	if err != nil {
 		t.Fatalf("unexpected err: %v", err)
 	}
 	p.Config(resmap.NewPluginHelpers(ldr, v, rf), yaml)
 	expected := "/kustomize/plugin/someteam.example.com/v1/sedtransformer/SedTransformer"
 	if !strings.HasSuffix(p.Path(), expected) {
 		t.Fatalf("expected suffix '%s', got '%s'", expected, p.Path())
 	}
 	expected = `apiVersion: someteam.example.com/v1
 argsFromFile: sed-input.txt
 argsOneLiner: one two
 kind: SedTransformer
 metadata:
  name: some-random-name
 `
 	if expected != string(p.Cfg()) {
 		t.Fatalf("expected cfg '%s', got '%s'", expected, string(p.Cfg()))
 	}
 	if len(p.Args()) != 5 {
 		t.Fatalf("unexpected arg len %d, %v", len(p.Args()), p.Args())
 	}
 	if p.Args()[0] != "one" ||
 		p.Args()[1] != "two" ||
 		p.Args()[2] != "s/$FOO/foo/g" ||
 		p.Args()[3] != "s/$BAR/bar/g" ||
 		p.Args()[4] != "\\ \\ \\ " {
 		t.Fatalf("unexpected arg array: %v", p.Args())
 	}
 }
 func makeConfigMap(rf *resource.Factory, name, behavior string, hashValue *string) *resource.Resource {
 	r := rf.FromMap(map[string]interface{}{
 		"apiVersion": "v1",
 		"kind":       "ConfigMap",
 		"metadata":   map[string]interface{}{"name": name},
 	})
 	annotations := map[string]string{}
 	if behavior != "" {
 		annotations[BehaviorAnnotation] = behavior
 	}
 	if hashValue != nil {
 		annotations[HashAnnotation] = *hashValue
 	}
 	if len(annotations) > 0 {
 		r.SetAnnotations(annotations)
 	}
 	return r
 }
 func makeConfigMapOptions(rf *resource.Factory, name, behavior string, disableHash bool) *resource.Resource {
 	return rf.FromMapAndOption(map[string]interface{}{
 		"apiVersion": "v1",
 		"kind":       "ConfigMap",
 		"metadata":   map[string]interface{}{"name": name},
 	}, &types.GeneratorArgs{Behavior: behavior}, &types.GeneratorOptions{DisableNameSuffixHash: disableHash})
 }
 func strptr(s string) *string {
 	return &s
 }
 func TestUpdateResourceOptions(t *testing.T) {
 	p, err := NewExecPlugin("")
 	if !os.IsNotExist(err) {
 		t.Fatalf("unexpected error: %v", err.Error())
 	}
 	rf := resource.NewFactory(kunstruct.NewKunstructuredFactoryImpl())
 	in := resmap.New()
 	expected := resmap.New()
 	cases := []struct {
 		behavior  string
 		needsHash bool
 		hashValue *string
 	}{
 		{hashValue: strptr("false")},
 		{hashValue: strptr("true"), needsHash: true},
 		{behavior: "replace"},
 		{behavior: "merge"},
 		{behavior: "create"},
 		{behavior: "nonsense"},
 		{behavior: "merge", hashValue: strptr("false")},
 		{behavior: "merge", hashValue: strptr("true"), needsHash: true},
 	}
 	for i, c := range cases {
 		name := fmt.Sprintf("test%d", i)
 		in.Append(makeConfigMap(rf, name, c.behavior, c.hashValue))
 		expected.Append(makeConfigMapOptions(rf, name, c.behavior, !c.needsHash))
 	}
 	actual, err := p.UpdateResourceOptions(in)
 	if err != nil {
 		t.Fatalf("unexpected error: %v", err.Error())
 	}
 	for i, a := range expected.Resources() {
 		b := actual.GetByIndex(i)
 		if b == nil {
 			t.Fatalf("resource %d missing from processed map", i)
 		}
 		if !a.Equals(b) {
 			t.Errorf("expected %v got %v", a, b)
 		}
 		if a.NeedHashSuffix() != b.NeedHashSuffix() {
 			t.Errorf("")
 		}
 		if a.Behavior() != b.Behavior() {
 			t.Errorf("expected %v got %v", a.Behavior(), b.Behavior())
 		}
 	}
 }
 func TestUpdateResourceOptionsWithInvalidHashAnnotationValues(t *testing.T) {
 	p, err := NewExecPlugin("")
 	if !os.IsNotExist(err) {
 		t.Fatalf("unexpected error: %v", err.Error())
 	}
 	rf := resource.NewFactory(kunstruct.NewKunstructuredFactoryImpl())
 	cases := []string{
 		"",
 		"FaLsE",
 		"TrUe",
 		"potato",
 	}
 	for i, c := range cases {
 		name := fmt.Sprintf("test%d", i)
 		in := resmap.New()
 		in.Append(makeConfigMap(rf, name, "", &c))
 		_, err := p.UpdateResourceOptions(in)
 		if err == nil {
 			t.Errorf("expected error from value %q", c)
 		}
 	}
 }
--- a/api/provenance/provenance.go
+++ b/api/provenance/provenance.go
@@ -1,54 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package provenance
 import (
 	"fmt"
 	"io"
 	"runtime"
 )
 var (
 	version = "unknown"
 	// sha1 from git, output of $(git rev-parse HEAD)
 	gitCommit = "$Format:%H$"
 	// build date in ISO8601 format, output of $(date -u +'%Y-%m-%dT%H:%M:%SZ')
 	buildDate = "1970-01-01T00:00:00Z"
 	goos      = runtime.GOOS
 	goarch    = runtime.GOARCH
 )
 // Provenance holds information about the build of an executable.
 type Provenance struct {
 	// Version of the kustomize binary.
 	Version string `json:"version"`
 	// GitCommit is a git commit
 	GitCommit string `json:"gitCommit"`
 	// BuildDate is date of the build.
 	BuildDate string `json:"buildDate"`
 	// GoOs holds OS name.
 	GoOs string `json:"goOs"`
 	// GoArch holds architecture name.
 	GoArch string `json:"goArch"`
 }
 // GetProvenance returns an instance of Provenance.
 func GetProvenance() Provenance {
 	return Provenance{
 		version,
 		gitCommit,
 		buildDate,
 		goos,
 		goarch,
 	}
 }
 // Print prints provenance info.
 func (v Provenance) Print(w io.Writer, short bool) {
 	if short {
 		fmt.Fprintf(w, "%s\n", v.Version)
 	} else {
 		fmt.Fprintf(w, "Version: %+v\n", v)
 	}
 }
--- a/api/resmap/patchfactory.go
+++ b/api/resmap/patchfactory.go
@@ -1,15 +0,0 @@
 /// Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package patch holds miscellaneous interfaces used by kustomize.
 package resmap
 import (
 	"sigs.k8s.io/kustomize/api/resource"
 )
 // PatchFactory makes transformers that require k8sdeps.
 type PatchFactory interface {
 	MergePatches(patches []*resource.Resource,
 		rf *resource.Factory) (ResMap, error)
 }
--- a/api/target/basereusenameprefix_test.go
+++ b/api/target/basereusenameprefix_test.go
@@ -1,199 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target_test
 import (
 	"testing"
 	"sigs.k8s.io/kustomize/api/testutils/kusttest"
 )
 // Here is a structure of a kustomization of two components, component1
 // and component2, that both use a shared postgres definition, which
 // they would individually adjust. This test case checks that the name
 // prefix does not cause a name reference conflict.
 //
 //                   root
 //              /            \
 //  component1/overlay  component2/overlay
 //             |              |
 //    component1/base    component2/base
 //              \            /
 //                   base
 //
 // This is the directory layout:
 //
 // ├── component1
 // │   ├── base
 // │   │   └── kustomization.yaml
 // │   └── overlay
 // │       └── kustomization.yaml
 // ├── component2
 // │   ├── base
 // │   │   └── kustomization.yaml
 // │   └── overlay
 // │       └── kustomization.yaml
 // ├── shared
 // │   ├── kustomization.yaml
 // │   └── resources.yaml
 // ├── kustomization.yaml
 func TestBaseReuseNameConflict(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app")
 	th.WriteK("/app/component1/base", `
 resources:
  - ../../shared
 namePrefix: component1-
 `)
 	th.WriteK("/app/component1/overlay", `
 resources:
  - ../base
 namePrefix: overlay-
 `)
 	th.WriteK("/app/component2/base", `
 resources:
  - ../../shared
 namePrefix: component2-
 `)
 	th.WriteK("/app/component2/overlay", `
 resources:
  - ../base
 namePrefix: overlay-
 `)
 	th.WriteK("/app/shared", `
 resources:
  - resources.yaml
 `)
 	th.WriteF("/app/shared/resources.yaml", `
 ---
 kind: PersistentVolumeClaim
 apiVersion: v1
 metadata:
  name: postgres
 spec:
  resources:
    requests:
      storage: 1Gi
  accessModes:
    - ReadWriteOnce
 ---
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: postgres
 spec:
  selector:
    matchLabels: {}
  strategy:
    type: Recreate
  template:
    spec:
      containers:
        - name: postgres
          image: postgres
          imagePullPolicy: IfNotPresent
          volumeMounts:
            - mountPath: /var/lib/postgresql
              name: data
          ports:
            - name: postgres
              containerPort: 5432
      volumes:
        - name: data
          persistentVolumeClaim:
            claimName: postgres
 `)
 	th.WriteK("/app", `
 resources:
  - component1/overlay
  - component2/overlay
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
  name: overlay-component1-postgres
 spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
 ---
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: overlay-component1-postgres
 spec:
  selector:
    matchLabels: {}
  strategy:
    type: Recreate
  template:
    spec:
      containers:
      - image: postgres
        imagePullPolicy: IfNotPresent
        name: postgres
        ports:
        - containerPort: 5432
          name: postgres
        volumeMounts:
        - mountPath: /var/lib/postgresql
          name: data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: overlay-component1-postgres
 ---
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
  name: overlay-component2-postgres
 spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 1Gi
 ---
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: overlay-component2-postgres
 spec:
  selector:
    matchLabels: {}
  strategy:
    type: Recreate
  template:
    spec:
      containers:
      - image: postgres
        imagePullPolicy: IfNotPresent
        name: postgres
        ports:
        - containerPort: 5432
          name: postgres
        volumeMounts:
        - mountPath: /var/lib/postgresql
          name: data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: overlay-component2-postgres
 `)
 }
--- a/api/target/complexcomposition_test.go
+++ b/api/target/complexcomposition_test.go
@@ -1,557 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target_test
 import (
 	"strings"
 	"testing"
 	"sigs.k8s.io/kustomize/api/testutils/kusttest"
 )
 const httpsService = `
 apiVersion: v1
 kind: Service
 metadata:
  name: my-https-svc
 spec:
  ports:
  - port: 443
    protocol: TCP
    name: https
  selector:
    app: my-app
 `
 func writeStatefulSetBase(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/base", `
 resources:
 - statefulset.yaml
 `)
 	th.WriteF("/app/base/statefulset.yaml", `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  serviceName: my-svc
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: app
        image: my-image
  volumeClaimTemplates:
  - spec:
      storageClassName: default
 `)
 }
 func writeHTTPSOverlay(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/https", `
 resources:
 - ../base
 - https-svc.yaml
 patchesStrategicMerge:
 - sts-patch.yaml
 `)
 	th.WriteF("/app/https/https-svc.yaml", httpsService)
 	th.WriteF("/app/https/sts-patch.yaml", `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  serviceName: my-https-svc
 `)
 }
 func writeHTTPSTransformerRaw(th *kusttest_test.KustTestHarness) {
 	th.WriteF("/app/https/service/https-svc.yaml", httpsService)
 	th.WriteF("/app/https/transformer/transformer.yaml", `
 apiVersion: builtin
 kind: PatchTransformer
 metadata:
  name: svcNameTran
 target: 
  group: apps
  version: v1
  kind: StatefulSet
  name: my-sts
 patch: |-
  apiVersion: apps/v1
  kind: StatefulSet
  metadata:
    name: my-sts
  spec:
    serviceName: my-https-svc
 `)
 }
 func writeHTTPSTransformerBase(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/https/service", `
 resources:
 - https-svc.yaml
 `)
 	th.WriteK("/app/https/transformer", `
 resources:
 - transformer.yaml
 `)
 	writeHTTPSTransformerRaw(th)
 }
 func writeConfigFromEnvOverlay(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/config", `
 resources:
 - ../base
 configMapGenerator:
 - name: my-config
  literals:
  - MY_ENV=foo
 generatorOptions:
  disableNameSuffixHash: true
 patchesStrategicMerge:
 - sts-patch.yaml
 `)
 	th.WriteF("/app/config/sts-patch.yaml", `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  template:
    spec:
      containers:
      - name: app
        envFrom:
        - configMapRef:
            name: my-config
 `)
 }
 func writeConfigFromEnvTransformerRaw(th *kusttest_test.KustTestHarness) {
 	th.WriteF("/app/config/map/generator.yaml", `
 apiVersion: builtin
 kind: ConfigMapGenerator
 metadata:
  name: my-config
 disableNameSuffixHash: true
 literals:
 - MY_ENV=foo
 `)
 	th.WriteF("/app/config/transformer/transformer.yaml", `
 apiVersion: builtin
 kind: PatchTransformer
 metadata:
  name: envFromConfigTrans
 target: 
  group: apps
  version: v1
  kind: StatefulSet
  name: my-sts
 patch: |-
  apiVersion: apps/v1
  kind: StatefulSet
  metadata:
    name: my-sts
  spec:
    template:
      spec:
        containers:
        - name: app
          envFrom:
          - configMapRef:
              name: my-config
 `)
 }
 func writeConfigFromEnvTransformerBase(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/config/map", `
 resources:
 - generator.yaml
 `)
 	th.WriteK("/app/config/transformer", `
 resources:
 - transformer.yaml
 `)
 	writeConfigFromEnvTransformerRaw(th)
 }
 func writeTolerationsOverlay(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/tolerations", `
 resources:
 - ../base
 patchesStrategicMerge:
 - sts-patch.yaml
 `)
 	th.WriteF("/app/tolerations/sts-patch.yaml", `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  template:
    spec:
      tolerations:
      - effect: NoExecute
        key: node.kubernetes.io/not-ready
        tolerationSeconds: 30
 `)
 }
 func writeTolerationsTransformerRaw(th *kusttest_test.KustTestHarness) {
 	th.WriteF("/app/tolerations/transformer.yaml", `
 apiVersion: builtin
 kind: PatchTransformer
 metadata:
  name: tolTrans
 target: 
  group: apps
  version: v1
  kind: StatefulSet
  name: my-sts
 patch: |-
  apiVersion: apps/v1
  kind: StatefulSet
  metadata:
    name: my-sts
  spec:
    template:
      spec:
        tolerations:
        - effect: NoExecute
          key: node.kubernetes.io/not-ready
          tolerationSeconds: 30
 `)
 }
 func writeTolerationsTransformerBase(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/tolerations", `
 resources:
 - transformer.yaml
 `)
 	writeTolerationsTransformerRaw(th)
 }
 func writeStorageOverlay(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/storage", `
 resources:
 - ../base
 patchesJson6902:
 - target:
    group: apps
    version: v1
    kind: StatefulSet
    name: my-sts
  path: sts-patch.json
 `)
 	th.WriteF("/app/storage/sts-patch.json", `
 [{"op": "replace", "path": "/spec/volumeClaimTemplates/0/spec/storageClassName", "value": "my-sc"}]
 `)
 }
 func writeStorageTransformerRaw(th *kusttest_test.KustTestHarness) {
 	th.WriteF("/app/storage/transformer.yaml", `
 apiVersion: builtin
 kind: PatchTransformer
 metadata:
  name: storageTrans
 target: 
  group: apps
  version: v1
  kind: StatefulSet
  name: my-sts
 patch: |-
  [{"op": "replace", "path": "/spec/volumeClaimTemplates/0/spec/storageClassName", "value": "my-sc"}]
 `)
 }
 func writeStorageTransformerBase(th *kusttest_test.KustTestHarness) {
 	th.WriteK("/app/storage", `
 resources:
 - transformer.yaml
 `)
 	writeStorageTransformerRaw(th)
 }
 func writePatchingOverlays(th *kusttest_test.KustTestHarness) {
 	writeStorageOverlay(th)
 	writeConfigFromEnvOverlay(th)
 	writeTolerationsOverlay(th)
 	writeHTTPSOverlay(th)
 }
 func writePatchingTransformersRaw(th *kusttest_test.KustTestHarness) {
 	writeStorageTransformerRaw(th)
 	writeConfigFromEnvTransformerRaw(th)
 	writeTolerationsTransformerRaw(th)
 	writeHTTPSTransformerRaw(th)
 }
 // Similar to writePatchingTransformersRaw, except here the
 // transformers and related artifacts are addressable as _bases_.
 // They are listed in a kustomization file, and consumers of
 // the plugin refer to the kustomization instead of to the local
 // file in the "transformers:" field.
 //
 // Using bases makes the set of files relocatable with
 // respect to the overlays, and avoids the need to relax load
 // restrictions on file paths reaching outside the `dev` and
 // `prod` kustomization roots.  I.e. with bases tests can use
 // NewKustTestHarness instead of NewKustTestHarnessNoLoadRestrictor.
 //
 // Using transformer plugins from _bases_ means the plugin config
 // must be self-contained, i.e. the config may not have fields that
 // refer to local files, since those files won't be present when
 // the plugin is instantiated and used.
 func writePatchingTransformerBases(th *kusttest_test.KustTestHarness) {
 	writeStorageTransformerBase(th)
 	writeConfigFromEnvTransformerBase(th)
 	writeTolerationsTransformerBase(th)
 	writeHTTPSTransformerBase(th)
 }
 // Here's a complex kustomization scenario that combines multiple overlays
 // on a common base:
 //
 //                 dev                       prod
 //                  |                         |
 //                  |                         |
 //        + ------- +          + ------------ + ------------- +
 //        |         |          |              |               |
 //        |         |          |              |               |
 //        v         |          v              v               v
 //     storage      + -----> config       tolerations       https
 //        |                    |              |               |
 //        |                    |              |               |
 //        |                    + --- +  + --- +               |
 //        |                          |  |                     |
 //        |                          v  v                     |
 //        + -----------------------> base <------------------ +
 //
 // The base resource is a statefulset. Each intermediate overlay manages or
 // generates new resources and patches different aspects of the same base
 // resource, without using any of the `namePrefix`, `nameSuffix` or `namespace`
 // kustomization keywords.
 //
 // Intermediate overlays:
 //   - storage: Changes the storage class of the stateful set with a JSON patch.
 //   - config: Generates a config map and adds a field as an environment
 //             variable.
 //   - tolerations: Adds a new tolerations field in the spec.
 //   - https: Adds a new service resource and changes the service name in the
 //            stateful set.
 //
 // Top overlays:
 //   - dev: Combines the storage and config intermediate overlays.
 //   - prod: Combines the config, tolerations and https intermediate overlays.
 func TestComplexComposition_Dev_Failure(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/dev")
 	writeStatefulSetBase(th)
 	writePatchingOverlays(th)
 	th.WriteK("/app/dev", `
 resources:
 - ../storage
 - ../config
 `)
 	_, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err == nil {
 		t.Fatalf("Expected resource accumulation error")
 	}
 	if !strings.Contains(
 		err.Error(), "already registered id: apps_v1_StatefulSet|~X|my-sts") {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 }
 const devDesiredResult = `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  selector:
    matchLabels:
      app: my-app
  serviceName: my-svc
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - envFrom:
        - configMapRef:
            name: my-config
        image: my-image
        name: app
  volumeClaimTemplates:
  - spec:
      storageClassName: my-sc
 ---
 apiVersion: v1
 data:
  MY_ENV: foo
 kind: ConfigMap
 metadata:
  name: my-config
 `
 func TestComplexComposition_Dev_SuccessWithRawTransformers(t *testing.T) {
 	th := kusttest_test.NewKustTestHarnessNoLoadRestrictor(t, "/app/dev")
 	writeStatefulSetBase(th)
 	writePatchingTransformersRaw(th)
 	th.WriteK("/app/dev", `
 resources:
 - ../base
 generators:
 - ../config/map/generator.yaml
 transformers:
 - ../config/transformer/transformer.yaml
 - ../storage/transformer.yaml
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, devDesiredResult)
 }
 func TestComplexComposition_Dev_SuccessWithBaseTransformers(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/dev")
 	writeStatefulSetBase(th)
 	writePatchingTransformerBases(th)
 	th.WriteK("/app/dev", `
 resources:
 - ../base
 generators:
 - ../config/map
 transformers:
 - ../config/transformer
 - ../storage
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, devDesiredResult)
 }
 func TestComplexComposition_Prod_Failure(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/prod")
 	writeStatefulSetBase(th)
 	writePatchingOverlays(th)
 	th.WriteK("/app/prod", `
 resources:
 - ../config
 - ../tolerations
 - ../https
 `)
 	_, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err == nil {
 		t.Fatalf("Expected resource accumulation error")
 	}
 	if !strings.Contains(
 		err.Error(), "already registered id: apps_v1_StatefulSet|~X|my-sts") {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 }
 const prodDesiredResult = `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: my-sts
 spec:
  selector:
    matchLabels:
      app: my-app
  serviceName: my-https-svc
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - envFrom:
        - configMapRef:
            name: my-config
        image: my-image
        name: app
      tolerations:
      - effect: NoExecute
        key: node.kubernetes.io/not-ready
        tolerationSeconds: 30
  volumeClaimTemplates:
  - spec:
      storageClassName: default
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: my-https-svc
 spec:
  ports:
  - name: https
    port: 443
    protocol: TCP
  selector:
    app: my-app
 ---
 apiVersion: v1
 data:
  MY_ENV: foo
 kind: ConfigMap
 metadata:
  name: my-config
 `
 func TestComplexComposition_Prod_SuccessWithRawTransformers(t *testing.T) {
 	th := kusttest_test.NewKustTestHarnessNoLoadRestrictor(t, "/app/prod")
 	writeStatefulSetBase(th)
 	writePatchingTransformersRaw(th)
 	th.WriteK("/app/prod", `
 resources:
 - ../base
 - ../https/service/https-svc.yaml
 generators:
 - ../config/map/generator.yaml
 transformers:
 - ../config/transformer/transformer.yaml
 - ../https/transformer/transformer.yaml
 - ../tolerations/transformer.yaml
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, prodDesiredResult)
 }
 func TestComplexComposition_Prod_SuccessWithBaseTransformers(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/prod")
 	writeStatefulSetBase(th)
 	writePatchingTransformerBases(th)
 	th.WriteK("/app/prod", `
 resources:
 - ../base
 - ../https/service
 generators:
 - ../config/map
 transformers:
 - ../config/transformer
 - ../https/transformer
 - ../tolerations
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Unexpected err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, prodDesiredResult)
 }
--- a/api/target/customconfigofbuiltinplugin_test.go
+++ b/api/target/customconfigofbuiltinplugin_test.go
@@ -1,216 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target_test
 import (
 	"testing"
 	"sigs.k8s.io/kustomize/api/testutils/kusttest"
 )
 // Demo custom configuration of a builtin transformation.
 // This is a NamePrefixer that only touches Deployments
 // and Services.
 func TestCustomNamePrefixer(t *testing.T) {
 	tc := kusttest_test.NewPluginTestEnv(t).Set()
 	defer tc.Reset()
 	tc.BuildGoPlugin(
 		"builtin", "", "PrefixSuffixTransformer")
 	th := kusttest_test.NewKustTestHarnessAllowPlugins(t, "/app")
 	th.WriteK("/app", `
 resources:
 - deployment.yaml
 - role.yaml
 - service.yaml
 transformers:
 - prefixer.yaml
 `)
 	th.WriteF("/app/prefixer.yaml", `
 apiVersion: builtin
 kind: PrefixSuffixTransformer
 metadata:
  name: customPrefixer
 prefix: zzz-
 fieldSpecs:
 - kind: Deployment
  path: metadata/name
 - kind: Service
  path: metadata/name
 `)
 	th.WriteF("/app/deployment.yaml", `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: myDeployment
 spec:
  template:
    metadata:
      labels:
        backend: awesome
    spec:
      containers:
      - name: whatever
        image: whatever
 `)
 	th.WriteF("/app/role.yaml", `
 apiVersion: v1
 kind: Role
 metadata:
  name: myRole
 `)
 	th.WriteF("/app/service.yaml", `
 apiVersion: v1
 kind: Service
 metadata:
  name: myService
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: zzz-myDeployment
 spec:
  template:
    metadata:
      labels:
        backend: awesome
    spec:
      containers:
      - image: whatever
        name: whatever
 ---
 apiVersion: v1
 kind: Role
 metadata:
  name: myRole
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: zzz-myService
 `)
 }
 // Demo custom configuration as a base.
 func TestReusableCustomNamePrefixer(t *testing.T) {
 	tc := kusttest_test.NewPluginTestEnv(t).Set()
 	defer tc.Reset()
 	tc.BuildGoPlugin(
 		"builtin", "", "PrefixSuffixTransformer")
 	tc.BuildGoPlugin(
 		"builtin", "", "LabelTransformer")
 	th := kusttest_test.NewKustTestHarnessAllowPlugins(t, "/app/foo")
 	// This kustomization file contains resources that
 	// all happen to be plugin configurations. This makes
 	// these plugins all available as part of a base,
 	// re-usable in any number of other kustomizations.
 	// Just specify the path (or URL) to this base in the
 	// "transformers:" field (not the "resources" field).
 	th.WriteK("/app/mytransformers", `
 resources:
 - prefixer.yaml
 - labeller.yaml
 `)
 	th.WriteF("/app/mytransformers/prefixer.yaml", `
 apiVersion: builtin
 kind: PrefixSuffixTransformer
 metadata:
  name: myPrefixer
 prefix: zzz-
 fieldSpecs:
 - kind: Deployment
  path: metadata/name
 - kind: Service
  path: metadata/name
 `)
 	th.WriteF("/app/mytransformers/labeller.yaml", `
 apiVersion: builtin
 kind: LabelTransformer
 metadata:
  name: myLabeller
 labels:
  company: acmeCorp
 fieldSpecs:
 - path: spec/template/metadata/labels
  kind: Deployment
 `)
 	th.WriteK("/app/foo", `
 resources:
 - deployment.yaml
 - role.yaml
 - service.yaml
 transformers:
 - ../mytransformers
 `)
 	th.WriteF("/app/foo/deployment.yaml", `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: myDeployment
 spec:
  template:
    metadata:
      labels:
        backend: awesome
    spec:
      containers:
      - name: whatever
        image: whatever
 `)
 	th.WriteF("/app/foo/role.yaml", `
 apiVersion: v1
 kind: Role
 metadata:
  name: myRole
 `)
 	th.WriteF("/app/foo/service.yaml", `
 apiVersion: v1
 kind: Service
 metadata:
  name: myService
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: zzz-myDeployment
 spec:
  template:
    metadata:
      labels:
        backend: awesome
        company: acmeCorp
    spec:
      containers:
      - image: whatever
        name: whatever
 ---
 apiVersion: v1
 kind: Role
 metadata:
  name: myRole
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: zzz-myService
 `)
 }
--- a/api/target/extendedpatch_test.go
+++ b/api/target/extendedpatch_test.go
--- a/api/target/inlinepatch_test.go
+++ b/api/target/inlinepatch_test.go
@@ -1,244 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target_test
 import (
 	"testing"
 	"sigs.k8s.io/kustomize/api/testutils/kusttest"
 )
 func makeResourcesForPatchTest(th *kusttest_test.KustTestHarness) {
 	th.WriteF("/app/base/deployment.yaml", `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: nginx
  labels:
    app: nginx
 spec:
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - name: nginx-persistent-storage
          mountPath: /tmp/ps
      volumes:
      - name: nginx-persistent-storage
        emptyDir: {}
      - configMap:
          name: configmap-in-base
        name: configmap-in-base
 `)
 }
 func TestStrategicMergePatchInline(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/base")
 	makeResourcesForPatchTest(th)
 	th.WriteK("/app/base", `
 resources:
 - deployment.yaml
 patchesStrategicMerge:
 - |-
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: nginx
  spec:
    template:
      spec:
        containers:
          - name: nginx
            image: image1
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  labels:
    app: nginx
  name: nginx
 spec:
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: image1
        name: nginx
        volumeMounts:
        - mountPath: /tmp/ps
          name: nginx-persistent-storage
      volumes:
      - emptyDir: {}
        name: nginx-persistent-storage
      - configMap:
          name: configmap-in-base
        name: configmap-in-base
 `)
 }
 func TestJSONPatchInline(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/base")
 	makeResourcesForPatchTest(th)
 	th.WriteK("/app/base", `
 resources:
 - deployment.yaml
 patchesJson6902:
 - target:
    group: apps
    version: v1
    kind: Deployment
    name: nginx
  patch: |-
    - op: replace
      path: /spec/template/spec/containers/0/image
      value: image1
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  labels:
    app: nginx
  name: nginx
 spec:
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: image1
        name: nginx
        volumeMounts:
        - mountPath: /tmp/ps
          name: nginx-persistent-storage
      volumes:
      - emptyDir: {}
        name: nginx-persistent-storage
      - configMap:
          name: configmap-in-base
        name: configmap-in-base
 `)
 }
 func TestExtendedPatchInlineJSON(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/base")
 	makeResourcesForPatchTest(th)
 	th.WriteK("/app/base", `
 resources:
 - deployment.yaml
 patches:
 - target:
    kind: Deployment
    name: nginx
  patch: |-
    - op: replace
      path: /spec/template/spec/containers/0/image
      value: image1
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  labels:
    app: nginx
  name: nginx
 spec:
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: image1
        name: nginx
        volumeMounts:
        - mountPath: /tmp/ps
          name: nginx-persistent-storage
      volumes:
      - emptyDir: {}
        name: nginx-persistent-storage
      - configMap:
          name: configmap-in-base
        name: configmap-in-base
 `)
 }
 func TestExtendedPatchInlineYAML(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app/base")
 	makeResourcesForPatchTest(th)
 	th.WriteK("/app/base", `
 resources:
 - deployment.yaml
 patches:
 - target:
    kind: Deployment
    name: nginx
  patch: |-
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: nginx
    spec:
      template:
        spec:
          containers:
            - name: nginx
              image: image1
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  labels:
    app: nginx
  name: nginx
 spec:
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: image1
        name: nginx
        volumeMounts:
        - mountPath: /tmp/ps
          name: nginx-persistent-storage
      volumes:
      - emptyDir: {}
        name: nginx-persistent-storage
      - configMap:
          name: configmap-in-base
        name: configmap-in-base
 `)
 }
--- a/api/target/kusttarget_configplugin.go
+++ b/api/target/kusttarget_configplugin.go
@@ -1,297 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target
 import (
 	"sigs.k8s.io/kustomize/api/plugins/builtinconfig"
 	"sigs.k8s.io/kustomize/api/plugins/builtinhelpers"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/types"
 )
 // Functions dedicated to configuring the builtin
 // transformer and generator plugins using config data
 // read from a kustomization file and from the
 // config.TransformerConfig, whose data may be a
 // mix of hardcoded values and data read from file.
 //
 // Non-builtin plugins will get their configuration
 // from their own dedicated structs and YAML files.
 //
 // There are some loops in the functions below because
 // the kustomization file would, say, allow someone to
 // request multiple secrets be made, or run multiple
 // image tag transforms.  In these cases, we'll need
 // N plugin instances with differing configurations.
 func (kt *KustTarget) configureBuiltinGenerators() (
 	result []resmap.Generator, err error) {
 	for _, bpt := range []builtinhelpers.BuiltinPluginType{
 		builtinhelpers.ConfigMapGenerator,
 		builtinhelpers.SecretGenerator,
 	} {
 		r, err := generatorConfigurators[bpt](
 			kt, bpt, builtinhelpers.GeneratorFactories[bpt])
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, r...)
 	}
 	return result, nil
 }
 func (kt *KustTarget) configureBuiltinTransformers(
 	tc *builtinconfig.TransformerConfig) (
 	result []resmap.Transformer, err error) {
 	for _, bpt := range []builtinhelpers.BuiltinPluginType{
 		builtinhelpers.PatchStrategicMergeTransformer,
 		builtinhelpers.PatchTransformer,
 		builtinhelpers.NamespaceTransformer,
 		builtinhelpers.PrefixSuffixTransformer,
 		builtinhelpers.LabelTransformer,
 		builtinhelpers.AnnotationsTransformer,
 		builtinhelpers.PatchJson6902Transformer,
 		builtinhelpers.ReplicaCountTransformer,
 		builtinhelpers.ImageTagTransformer,
 	} {
 		r, err := transformerConfigurators[bpt](
 			kt, bpt, builtinhelpers.TransformerFactories[bpt], tc)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, r...)
 	}
 	return result, nil
 }
 type gFactory func() resmap.GeneratorPlugin
 var generatorConfigurators = map[builtinhelpers.BuiltinPluginType]func(
 	kt *KustTarget,
 	bpt builtinhelpers.BuiltinPluginType,
 	factory gFactory) (result []resmap.Generator, err error){
 	builtinhelpers.SecretGenerator: func(kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f gFactory) (
 		result []resmap.Generator, err error) {
 		var c struct {
 			types.GeneratorOptions
 			types.SecretArgs
 		}
 		if kt.kustomization.GeneratorOptions != nil {
 			c.GeneratorOptions = *kt.kustomization.GeneratorOptions
 		}
 		for _, args := range kt.kustomization.SecretGenerator {
 			c.SecretArgs = args
 			p := f()
 			err := kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 	builtinhelpers.ConfigMapGenerator: func(kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f gFactory) (
 		result []resmap.Generator, err error) {
 		var c struct {
 			types.GeneratorOptions
 			types.ConfigMapArgs
 		}
 		if kt.kustomization.GeneratorOptions != nil {
 			c.GeneratorOptions = *kt.kustomization.GeneratorOptions
 		}
 		for _, args := range kt.kustomization.ConfigMapGenerator {
 			c.ConfigMapArgs = args
 			p := f()
 			err := kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 }
 type tFactory func() resmap.TransformerPlugin
 var transformerConfigurators = map[builtinhelpers.BuiltinPluginType]func(
 	kt *KustTarget,
 	bpt builtinhelpers.BuiltinPluginType,
 	f tFactory,
 	tc *builtinconfig.TransformerConfig) (result []resmap.Transformer, err error){
 	builtinhelpers.NamespaceTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			types.ObjectMeta `json:"metadata,omitempty" yaml:"metadata,omitempty"`
 			FieldSpecs       []types.FieldSpec
 		}
 		c.Namespace = kt.kustomization.Namespace
 		c.FieldSpecs = tc.NameSpace
 		p := f()
 		err = kt.configureBuiltinPlugin(p, c, bpt)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, p)
 		return
 	},
 	builtinhelpers.PatchJson6902Transformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, _ *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			Target types.PatchTarget `json:"target,omitempty" yaml:"target,omitempty"`
 			Path   string            `json:"path,omitempty" yaml:"path,omitempty"`
 			JsonOp string            `json:"jsonOp,omitempty" yaml:"jsonOp,omitempty"`
 		}
 		for _, args := range kt.kustomization.PatchesJson6902 {
 			c.Target = *args.Target
 			c.Path = args.Path
 			c.JsonOp = args.Patch
 			p := f()
 			err = kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 	builtinhelpers.PatchStrategicMergeTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, _ *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		if len(kt.kustomization.PatchesStrategicMerge) == 0 {
 			return
 		}
 		var c struct {
 			Paths   []types.PatchStrategicMerge `json:"paths,omitempty" yaml:"paths,omitempty"`
 			Patches string                      `json:"patches,omitempty" yaml:"patches,omitempty"`
 		}
 		c.Paths = kt.kustomization.PatchesStrategicMerge
 		p := f()
 		err = kt.configureBuiltinPlugin(p, c, bpt)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, p)
 		return
 	},
 	builtinhelpers.PatchTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, _ *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		if len(kt.kustomization.Patches) == 0 {
 			return
 		}
 		var c struct {
 			Path   string          `json:"path,omitempty" yaml:"path,omitempty"`
 			Patch  string          `json:"patch,omitempty" yaml:"patch,omitempty"`
 			Target *types.Selector `json:"target,omitempty" yaml:"target,omitempty"`
 		}
 		for _, pc := range kt.kustomization.Patches {
 			c.Target = pc.Target
 			c.Patch = pc.Patch
 			c.Path = pc.Path
 			p := f()
 			err = kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 	builtinhelpers.LabelTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			Labels     map[string]string
 			FieldSpecs []types.FieldSpec
 		}
 		c.Labels = kt.kustomization.CommonLabels
 		c.FieldSpecs = tc.CommonLabels
 		p := f()
 		err = kt.configureBuiltinPlugin(p, c, bpt)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, p)
 		return
 	},
 	builtinhelpers.AnnotationsTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			Annotations map[string]string
 			FieldSpecs  []types.FieldSpec
 		}
 		c.Annotations = kt.kustomization.CommonAnnotations
 		c.FieldSpecs = tc.CommonAnnotations
 		p := f()
 		err = kt.configureBuiltinPlugin(p, c, bpt)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, p)
 		return
 	},
 	builtinhelpers.PrefixSuffixTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			Prefix     string
 			Suffix     string
 			FieldSpecs []types.FieldSpec
 		}
 		c.Prefix = kt.kustomization.NamePrefix
 		c.Suffix = kt.kustomization.NameSuffix
 		c.FieldSpecs = tc.NamePrefix
 		p := f()
 		err = kt.configureBuiltinPlugin(p, c, bpt)
 		if err != nil {
 			return nil, err
 		}
 		result = append(result, p)
 		return
 	},
 	builtinhelpers.ImageTagTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			ImageTag   types.Image
 			FieldSpecs []types.FieldSpec
 		}
 		for _, args := range kt.kustomization.Images {
 			c.ImageTag = args
 			c.FieldSpecs = tc.Images
 			p := f()
 			err = kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 	builtinhelpers.ReplicaCountTransformer: func(
 		kt *KustTarget, bpt builtinhelpers.BuiltinPluginType, f tFactory, tc *builtinconfig.TransformerConfig) (
 		result []resmap.Transformer, err error) {
 		var c struct {
 			Replica    types.Replica
 			FieldSpecs []types.FieldSpec
 		}
 		for _, args := range kt.kustomization.Replicas {
 			c.Replica = args
 			c.FieldSpecs = tc.Replicas
 			p := f()
 			err = kt.configureBuiltinPlugin(p, c, bpt)
 			if err != nil {
 				return nil, err
 			}
 			result = append(result, p)
 		}
 		return
 	},
 }
--- a/api/target/namespaces_test.go
+++ b/api/target/namespaces_test.go
@@ -1,602 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package target_test
 import (
 	"strings"
 	"testing"
 	"sigs.k8s.io/kustomize/api/testutils/kusttest"
 )
 func TestNamespacedSecrets(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/app")
 	th.WriteF("/app/secrets.yaml", `
 apiVersion: v1
 kind: Secret
 metadata:
  name: dummy
  namespace: default
 type: Opaque
 data:
  dummy: ""
 ---
 apiVersion: v1
 kind: Secret
 metadata:
  name: dummy
  namespace: kube-system
 type: Opaque
 data:
  dummy: ""
 `)
 	// This should find the proper secret.
 	th.WriteF("/app/role.yaml", `
 kind: ClusterRole
 apiVersion: rbac.authorization.k8s.io/v1
 metadata:
  name: dummy
 rules:
 - apiGroups: [""]
  resources: ["secrets"]
  resourceNames: ["dummy"]
  verbs: ["get"]
 `)
 	th.WriteK("/app", `
 resources:
 - secrets.yaml
 - role.yaml
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	// This validates Fix #1444. This should not be an error anymore -
 	// the secrets have the same name but are in different namespaces.
 	// The ClusterRole (by def) is not in a namespace,
 	// an in this case applies to *any* Secret resource
 	// named "dummy"
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: v1
 data:
  dummy: ""
 kind: Secret
 metadata:
  name: dummy
  namespace: default
 type: Opaque
 ---
 apiVersion: v1
 data:
  dummy: ""
 kind: Secret
 metadata:
  name: dummy
  namespace: kube-system
 type: Opaque
 ---
 apiVersion: rbac.authorization.k8s.io/v1
 kind: ClusterRole
 metadata:
  name: dummy
 rules:
 - apiGroups:
  - ""
  resourceNames:
  - dummy
  resources:
  - secrets
  verbs:
  - get
 `)
 }
 // TestNameAndNsTransformation validates that NamespaceTransformer,
 // PrefixSuffixTransformer and namereference transformers are
 // able to deal with simultaneous change of namespace and name.
 func TestNameAndNsTransformation(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/nameandns")
 	th.WriteK("/nameandns", `
 namePrefix: p1-
 nameSuffix: -s1
 namespace: newnamespace
 resources:
 - resources.yaml
 `)
 	th.WriteF("/nameandns/resources.yaml", `
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: cm1
 ---
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: cm2
  namespace: ns1
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: svc1
  namespace: ns1
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: svc2
  namespace: ns1
 ---
 apiVersion: v1
 kind: ServiceAccount
 metadata:
  name: sa1
  namespace: ns1
 ---
 apiVersion: v1
 kind: ServiceAccount
 metadata:
  name: sa2
  namespace: ns1
 ---
 apiVersion: rbac.authorization.k8s.io/v1
 kind: ClusterRoleBinding
 metadata:
  name: manager-rolebinding
 subjects:
 - kind: ServiceAccount
  name: sa1
  namespace: ns1
 - kind: ServiceAccount
  name: sa2
  namespace: ns1
 - kind: ServiceAccount
  name: sa3
  namespace: random
 - kind: ServiceAccount
  name: default
  namespace: irrelevant
 ---
 apiVersion: admissionregistration.k8s.io/v1beta1
 kind: ValidatingWebhookConfiguration
 metadata:
  name: example
 webhooks:
  - name: example1
    clientConfig:
      service:
        name: svc1
        namespace: ns1
  - name: example2
    clientConfig:
      service:
        name: svc2
        namespace: ns1
  - name: example3
    clientConfig:
      service:
        name: svc3
        namespace: random
 ---
 apiVersion: apiextensions.k8s.io/v1beta1
 kind: CustomResourceDefinition
 metadata:
  name: crds.my.org
 ---
 kind: ClusterRole
 metadata:
  name: cr1
 ---
 kind: ClusterRoleBinding
 metadata:
  name: crb1
 subjects:
 - kind: ServiceAccount
  name: default
  namespace: irrelevant
 ---
 kind: PersistentVolume
 metadata:
  name: pv1
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, `
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: p1-cm1-s1
  namespace: newnamespace
 ---
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: p1-cm2-s1
  namespace: newnamespace
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: p1-svc1-s1
  namespace: newnamespace
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: p1-svc2-s1
  namespace: newnamespace
 ---
 apiVersion: v1
 kind: ServiceAccount
 metadata:
  name: p1-sa1-s1
  namespace: newnamespace
 ---
 apiVersion: v1
 kind: ServiceAccount
 metadata:
  name: p1-sa2-s1
  namespace: newnamespace
 ---
 apiVersion: rbac.authorization.k8s.io/v1
 kind: ClusterRoleBinding
 metadata:
  name: p1-manager-rolebinding-s1
 subjects:
 - kind: ServiceAccount
  name: p1-sa1-s1
  namespace: newnamespace
 - kind: ServiceAccount
  name: p1-sa2-s1
  namespace: newnamespace
 - kind: ServiceAccount
  name: sa3
  namespace: random
 - kind: ServiceAccount
  name: default
  namespace: newnamespace
 ---
 apiVersion: admissionregistration.k8s.io/v1beta1
 kind: ValidatingWebhookConfiguration
 metadata:
  name: p1-example-s1
 webhooks:
 - clientConfig:
    service:
      name: p1-svc1-s1
      namespace: newnamespace
  name: example1
 - clientConfig:
    service:
      name: p1-svc2-s1
      namespace: newnamespace
  name: example2
 - clientConfig:
    service:
      name: svc3
      namespace: random
  name: example3
 ---
 apiVersion: apiextensions.k8s.io/v1beta1
 kind: CustomResourceDefinition
 metadata:
  name: crds.my.org
 ---
 kind: ClusterRole
 metadata:
  name: p1-cr1-s1
 ---
 kind: ClusterRoleBinding
 metadata:
  name: p1-crb1-s1
 subjects:
 - kind: ServiceAccount
  name: default
  namespace: newnamespace
 ---
 kind: PersistentVolume
 metadata:
  name: p1-pv1-s1
 `)
 }
 // This serie of constants is used to prove the need of
 // the namespace field in the objref field of the var declaration.
 // The following tests demonstrate that it creates umbiguous variable
 // declaration if two entities of the kind with the same name
 // but in different namespaces are declared.
 // This is tracking the following issue:
 // https://github.com/kubernetes-sigs/kustomize/issues/1298
 const namespaceNeedInVarMyApp string = `
 resources:
 - elasticsearch-dev-service.yaml
 - elasticsearch-test-service.yaml
 vars:
 - name: elasticsearch-test-service-name
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-test-protocol
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 - name: elasticsearch-dev-service-name
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-dev-protocol
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 `
 const namespaceNeedInVarDevResources string = `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: elasticsearch
  namespace: dev
 spec:
  template:
    spec:
      containers:
        - name: elasticsearch
          env:
            - name: DISCOVERY_SERVICE
              value: "$(elasticsearch-dev-service-name).monitoring.svc.cluster.local"
            - name: DISCOVERY_PROTOCOL
              value: "$(elasticsearch-dev-protocol)"
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: elasticsearch
  namespace: dev
 spec:
  ports:
    - name: transport
      port: 9300
      protocol: TCP
  clusterIP: None
 `
 const namespaceNeedInVarTestResources string = `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: elasticsearch
  namespace: test
 spec:
  template:
    spec:
      containers:
        - name: elasticsearch
          env:
            - name: DISCOVERY_SERVICE
              value: "$(elasticsearch-test-service-name).monitoring.svc.cluster.local"
            - name: DISCOVERY_PROTOCOL
              value: "$(elasticsearch-test-protocol)"
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: elasticsearch
  namespace: test
 spec:
  ports:
    - name: transport
      port: 9300
      protocol: UDP
  clusterIP: None
 `
 const namespaceNeedInVarExpectedOutput string = `
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: elasticsearch
  namespace: dev
 spec:
  template:
    spec:
      containers:
      - env:
        - name: DISCOVERY_SERVICE
          value: elasticsearch.monitoring.svc.cluster.local
        - name: DISCOVERY_PROTOCOL
          value: TCP
        name: elasticsearch
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: elasticsearch
  namespace: dev
 spec:
  clusterIP: None
  ports:
  - name: transport
    port: 9300
    protocol: TCP
 ---
 apiVersion: apps/v1
 kind: StatefulSet
 metadata:
  name: elasticsearch
  namespace: test
 spec:
  template:
    spec:
      containers:
      - env:
        - name: DISCOVERY_SERVICE
          value: elasticsearch.monitoring.svc.cluster.local
        - name: DISCOVERY_PROTOCOL
          value: UDP
        name: elasticsearch
 ---
 apiVersion: v1
 kind: Service
 metadata:
  name: elasticsearch
  namespace: test
 spec:
  clusterIP: None
  ports:
  - name: transport
    port: 9300
    protocol: UDP
 `
 // TestVariablesAmbiguous demonstrates how two variables pointing at two different resources
 // using the same name in different namespaces are treated as ambiguous if the namespace is
 // not specified
 func TestVariablesAmbiguous(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/namespaceNeedInVar/myapp")
 	th.WriteK("/namespaceNeedInVar/myapp", namespaceNeedInVarMyApp)
 	th.WriteF("/namespaceNeedInVar/myapp/elasticsearch-dev-service.yaml", namespaceNeedInVarDevResources)
 	th.WriteF("/namespaceNeedInVar/myapp/elasticsearch-test-service.yaml", namespaceNeedInVarTestResources)
 	_, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err == nil {
 		t.Fatalf("expected error")
 	}
 	if !strings.Contains(err.Error(), "unable to disambiguate") {
 		t.Fatalf("unexpected error %v", err)
 	}
 }
 const namespaceNeedInVarDevFolder string = `
 resources:
 - elasticsearch-dev-service.yaml
 vars:
 - name: elasticsearch-dev-service-name
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-dev-protocol
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 `
 const namespaceNeedInVarTestFolder string = `
 resources:
 - elasticsearch-test-service.yaml
 vars:
 - name: elasticsearch-test-service-name
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-test-protocol
  objref:
    kind: Service
    name: elasticsearch
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 `
 // TestVariablesAmbiguousWorkaround demonstrates a possible workaround
 // to TestVariablesAmbiguous problem. It requires to separate the variables
 // and resources into multiple kustomization context/folders instead of one.
 func TestVariablesAmbiguousWorkaround(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/namespaceNeedInVar/workaround")
 	th.WriteK("/namespaceNeedInVar/dev", namespaceNeedInVarDevFolder)
 	th.WriteF("/namespaceNeedInVar/dev/elasticsearch-dev-service.yaml", namespaceNeedInVarDevResources)
 	th.WriteK("/namespaceNeedInVar/test", namespaceNeedInVarTestFolder)
 	th.WriteF("/namespaceNeedInVar/test/elasticsearch-test-service.yaml", namespaceNeedInVarTestResources)
 	th.WriteK("/namespaceNeedInVar/workaround", `
 resources:
 - ../dev
 - ../test
 `)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, namespaceNeedInVarExpectedOutput)
 }
 const namespaceNeedInVarMyAppWithNamespace string = `
 resources:
 - elasticsearch-dev-service.yaml
 - elasticsearch-test-service.yaml
 vars:
 - name: elasticsearch-test-service-name
  objref:
    kind: Service
    name: elasticsearch
    namespace: test
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-test-protocol
  objref:
    kind: Service
    name: elasticsearch
    namespace: test
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 - name: elasticsearch-dev-service-name
  objref:
    kind: Service
    name: elasticsearch
    namespace: dev
    apiVersion: v1
  fieldref:
    fieldpath: metadata.name
 - name: elasticsearch-dev-protocol
  objref:
    kind: Service
    name: elasticsearch
    namespace: dev
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 `
 // TestVariablesDisambiguatedWithNamespace demonstrates that adding the namespace
 // to the variable declarations allows to disambiguate the variables.
 func TestVariablesDisambiguatedWithNamespace(t *testing.T) {
 	th := kusttest_test.NewKustTestHarness(t, "/namespaceNeedInVar/myapp")
 	th.WriteK("/namespaceNeedInVar/myapp", namespaceNeedInVarMyAppWithNamespace)
 	th.WriteF("/namespaceNeedInVar/myapp/elasticsearch-dev-service.yaml", namespaceNeedInVarDevResources)
 	th.WriteF("/namespaceNeedInVar/myapp/elasticsearch-test-service.yaml", namespaceNeedInVarTestResources)
 	m, err := th.MakeKustTarget().MakeCustomizedResMap()
 	if err != nil {
 		t.Fatalf("Err: %v", err)
 	}
 	th.AssertActualEqualsExpected(m, namespaceNeedInVarExpectedOutput)
 }
--- a/api/transform/maptransformer.go
+++ b/api/transform/maptransformer.go
@@ -1,64 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package transform
 import (
 	"errors"
 	"fmt"
 	"sigs.k8s.io/kustomize/api/resmap"
 	"sigs.k8s.io/kustomize/api/types"
 )
 // mapTransformer applies a string->string map to fieldSpecs.
 type mapTransformer struct {
 	m          map[string]string
 	fieldSpecs []types.FieldSpec
 }
 var _ resmap.Transformer = &mapTransformer{}
 // NewMapTransformer construct a mapTransformer.
 func NewMapTransformer(
 	pc []types.FieldSpec, m map[string]string) (resmap.Transformer, error) {
 	if m == nil {
 		return newNoOpTransformer(), nil
 	}
 	if pc == nil {
 		return nil, errors.New("fieldSpecs is not expected to be nil")
 	}
 	return &mapTransformer{fieldSpecs: pc, m: m}, nil
 }
 // Transform apply each <key, value> pair in the mapTransformer to the
 // fields specified in mapTransformer.
 func (o *mapTransformer) Transform(m resmap.ResMap) error {
 	for _, r := range m.Resources() {
 		for _, path := range o.fieldSpecs {
 			if !r.OrgId().IsSelected(&path.Gvk) {
 				continue
 			}
 			err := MutateField(
 				r.Map(), path.PathSlice(),
 				path.CreateIfNotPresent, o.addMap)
 			if err != nil {
 				return err
 			}
 		}
 	}
 	return nil
 }
 func (o *mapTransformer) addMap(in interface{}) (interface{}, error) {
 	m, ok := in.(map[string]interface{})
 	if in == nil {
 		m = map[string]interface{}{}
 	} else if !ok {
 		return nil, fmt.Errorf("%#v is expected to be %T", in, m)
 	}
 	for k, v := range o.m {
 		m[k] = v
 	}
 	return m, nil
 }
--- a/api/transform/nooptransformer.go
+++ b/api/transform/nooptransformer.go
@@ -1,21 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package transform
 import "sigs.k8s.io/kustomize/api/resmap"
 // noOpTransformer contains a no-op transformer.
 type noOpTransformer struct{}
 var _ resmap.Transformer = &noOpTransformer{}
 // newNoOpTransformer constructs a noOpTransformer.
 func newNoOpTransformer() resmap.Transformer {
 	return &noOpTransformer{}
 }
 // Transform does nothing.
 func (o *noOpTransformer) Transform(_ resmap.ResMap) error {
 	return nil
 }
--- a/api/types/configmapargs.go
+++ b/api/types/configmapargs.go
@@ -1,10 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // ConfigMapArgs contains the metadata of how to generate a configmap.
 type ConfigMapArgs struct {
 	// GeneratorArgs for the configmap.
 	GeneratorArgs `json:",inline,omitempty" yaml:",inline,omitempty"`
 }
--- a/api/types/doc.go
+++ b/api/types/doc.go
@@ -1,9 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // Package types holds the definition of the kustomization struct and
 // supporting structs.  It's the k8s API conformant object that describes
 // a set of generation and transformation operations to create and/or
 // modify k8s resources.
 // A kustomization file is a serialization of this struct.
 package types
--- a/api/types/fix.go
+++ b/api/types/fix.go
@@ -1,51 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 import (
 	"log"
 	"regexp"
 	"sigs.k8s.io/yaml"
 )
 // FixKustomizationPreUnmarshalling modies the raw data
 // before marshalling - e.g. changes old field names to
 // new field names.
 func FixKustomizationPreUnmarshalling(data []byte) []byte {
 	deprecateFieldsMap := map[string]string{
 		"imageTags:": "images:",
 	}
 	for oldname, newname := range deprecateFieldsMap {
 		pattern := regexp.MustCompile(oldname)
 		data = pattern.ReplaceAll(data, []byte(newname))
 	}
 	if useLegacyPatch(data) {
 		pattern := regexp.MustCompile("patches:")
 		data = pattern.ReplaceAll(data, []byte("patchesStrategicMerge:"))
 	}
 	return data
 }
 func useLegacyPatch(data []byte) bool {
 	found := false
 	var object map[string]interface{}
 	err := yaml.Unmarshal(data, &object)
 	if err != nil {
 		log.Fatalf("invalid content from %s\n", string(data))
 	}
 	if rawPatches, ok := object["patches"]; ok {
 		patches, ok := rawPatches.([]interface{})
 		if !ok {
 			log.Fatalf("invalid patches from %v\n", rawPatches)
 		}
 		for _, p := range patches {
 			_, ok := p.(string)
 			if ok {
 				found = true
 			}
 		}
 	}
 	return found
 }
--- a/api/types/garbagepolicy.go
+++ b/api/types/garbagepolicy.go
@@ -1,12 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 //go:generate stringer -type=GarbagePolicy
 type GarbagePolicy int
 const (
 	GarbageIgnore GarbagePolicy = iota + 1
 	GarbageCollect
 )
--- a/api/types/genargs_test.go
+++ b/api/types/genargs_test.go
@@ -1,37 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types_test
 import (
 	"testing"
 	. "sigs.k8s.io/kustomize/api/types"
 )
 func TestGenArgs_String(t *testing.T) {
 	tests := []struct {
 		ga       *GenArgs
 		expected string
 	}{
 		{
 			ga:       nil,
 			expected: "{nilGenArgs}",
 		},
 		{
 			ga:       &GenArgs{},
 			expected: "{nsfx:false,beh:unspecified}",
 		},
 		{
 			ga: NewGenArgs(
 				&GeneratorArgs{Behavior: "merge"},
 				&GeneratorOptions{DisableNameSuffixHash: false}),
 			expected: "{nsfx:true,beh:merge}",
 		},
 	}
 	for _, test := range tests {
 		if test.ga.String() != test.expected {
 			t.Fatalf("Expected '%s', got '%s'", test.expected, test.ga.String())
 		}
 	}
 }
--- a/api/types/generatorargs.go
+++ b/api/types/generatorargs.go
@@ -1,24 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // GeneratorArgs contains arguments common to ConfigMap and Secret generators.
 type GeneratorArgs struct {
 	// Namespace for the configmap, optional
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 	// Name - actually the partial name - of the generated resource.
 	// The full name ends up being something like
 	// NamePrefix + this.Name + hash(content of generated resource).
 	Name string `json:"name,omitempty" yaml:"name,omitempty"`
 	// Behavior of generated resource, must be one of:
 	//   'create': create a new one
 	//   'replace': replace the existing one
 	//   'merge': merge with the existing one
 	Behavior string `json:"behavior,omitempty" yaml:"behavior,omitempty"`
 	// KvPairSources for the generator.
 	KvPairSources `json:",inline,omitempty" yaml:",inline,omitempty"`
 }
--- a/api/types/generatoroptions.go
+++ b/api/types/generatoroptions.go
@@ -1,18 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // GeneratorOptions modify behavior of all ConfigMap and Secret generators.
 type GeneratorOptions struct {
 	// Labels to add to all generated resources.
 	Labels map[string]string `json:"labels,omitempty" yaml:"labels,omitempty"`
 	// Annotations to add to all generated resources.
 	Annotations map[string]string `json:"annotations,omitempty" yaml:"annotations,omitempty"`
 	// DisableNameSuffixHash if true disables the default behavior of adding a
 	// suffix to the names of generated resources that is a hash of the
 	// resource contents.
 	DisableNameSuffixHash bool `json:"disableNameSuffixHash,omitempty" yaml:"disableNameSuffixHash,omitempty"`
 }
--- a/api/types/image.go
+++ b/api/types/image.go
@@ -1,21 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // Image contains an image name, a new name, a new tag or digest,
 // which will replace the original name and tag.
 type Image struct {
 	// Name is a tag-less image name.
 	Name string `json:"name,omitempty" yaml:"name,omitempty"`
 	// NewName is the value used to replace the original name.
 	NewName string `json:"newName,omitempty" yaml:"newName,omitempty"`
 	// NewTag is the value used to replace the original tag.
 	NewTag string `json:"newTag,omitempty" yaml:"newTag,omitempty"`
 	// Digest is the value used to replace the original image tag.
 	// If digest is present NewTag value is ignored.
 	Digest string `json:"digest,omitempty" yaml:"digest,omitempty"`
 }
--- a/api/types/inventory.go
+++ b/api/types/inventory.go
@@ -1,16 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // Inventory records all objects touched in a build operation.
 type Inventory struct {
 	Type      string   `json:"type,omitempty" yaml:"type,omitempty"`
 	ConfigMap NameArgs `json:"configMap,omitempty" yaml:"configMap,omitempty"`
 }
 // NameArgs holds both namespace and name.
 type NameArgs struct {
 	Name      string `json:"name,omitempty" yaml:"name,omitempty"`
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 }
--- a/api/types/kustomization.go
+++ b/api/types/kustomization.go
@@ -1,151 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 const (
 	KustomizationVersion = "kustomize.config.k8s.io/v1beta1"
 	KustomizationKind    = "Kustomization"
 )
 // Kustomization holds the information needed to generate customized k8s api resources.
 type Kustomization struct {
 	TypeMeta `json:",inline" yaml:",inline"`
 	//
 	// Operators - what kustomize can do.
 	//
 	// NamePrefix will prefix the names of all resources mentioned in the kustomization
 	// file including generated configmaps and secrets.
 	NamePrefix string `json:"namePrefix,omitempty" yaml:"namePrefix,omitempty"`
 	// NameSuffix will suffix the names of all resources mentioned in the kustomization
 	// file including generated configmaps and secrets.
 	NameSuffix string `json:"nameSuffix,omitempty" yaml:"nameSuffix,omitempty"`
 	// Namespace to add to all objects.
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 	// CommonLabels to add to all objects and selectors.
 	CommonLabels map[string]string `json:"commonLabels,omitempty" yaml:"commonLabels,omitempty"`
 	// CommonAnnotations to add to all objects.
 	CommonAnnotations map[string]string `json:"commonAnnotations,omitempty" yaml:"commonAnnotations,omitempty"`
 	// PatchesStrategicMerge specifies the relative path to a file
 	// containing a strategic merge patch.  Format documented at
 	// https://github.com/kubernetes/community/blob/master/contributors/devel/strategic-merge-patch.md
 	// URLs and globs are not supported.
 	PatchesStrategicMerge []PatchStrategicMerge `json:"patchesStrategicMerge,omitempty" yaml:"patchesStrategicMerge,omitempty"`
 	// JSONPatches is a list of JSONPatch for applying JSON patch.
 	// Format documented at https://tools.ietf.org/html/rfc6902
 	// and http://jsonpatch.com
 	PatchesJson6902 []PatchJson6902 `json:"patchesJson6902,omitempty" yaml:"patchesJson6902,omitempty"`
 	// Patches is a list of patches, where each one can be either a
 	// Strategic Merge Patch or a JSON patch.
 	// Each patch can be applied to multiple target objects.
 	Patches []Patch `json:"patches,omitempty" yaml:"patches,omitempty"`
 	// Images is a list of (image name, new name, new tag or digest)
 	// for changing image names, tags or digests. This can also be achieved with a
 	// patch, but this operator is simpler to specify.
 	Images []Image `json:"images,omitempty" yaml:"images,omitempty"`
 	// Replicas is a list of {resourcename, count} that allows for simpler replica
 	// specification. This can also be done with a patch.
 	Replicas []Replica `json:"replicas,omitempty" yaml:"replicas,omitempty"`
 	// Vars allow things modified by kustomize to be injected into a
 	// kubernetes object specification. A var is a name (e.g. FOO) associated
 	// with a field in a specific resource instance.  The field must
 	// contain a value of type string/bool/int/float, and defaults to the name field
 	// of the instance.  Any appearance of "$(FOO)" in the object
 	// spec will be replaced at kustomize build time, after the final
 	// value of the specified field has been determined.
 	Vars []Var `json:"vars,omitempty" yaml:"vars,omitempty"`
 	//
 	// Operands - what kustomize operates on.
 	//
 	// Resources specifies relative paths to files holding YAML representations
 	// of kubernetes API objects, or specifcations of other kustomizations
 	// via relative paths, absolute paths, or URLs.
 	Resources []string `json:"resources,omitempty" yaml:"resources,omitempty"`
 	// Crds specifies relative paths to Custom Resource Definition files.
 	// This allows custom resources to be recognized as operands, making
 	// it possible to add them to the Resources list.
 	// CRDs themselves are not modified.
 	Crds []string `json:"crds,omitempty" yaml:"crds,omitempty"`
 	// Deprecated.
 	// Anything that would have been specified here should
 	// be specified in the Resources field instead.
 	Bases []string `json:"bases,omitempty" yaml:"bases,omitempty"`
 	//
 	// Generators (operators that create operands)
 	//
 	// ConfigMapGenerator is a list of configmaps to generate from
 	// local data (one configMap per list item).
 	// The resulting resource is a normal operand, subject to
 	// name prefixing, patching, etc.  By default, the name of
 	// the map will have a suffix hash generated from its contents.
 	ConfigMapGenerator []ConfigMapArgs `json:"configMapGenerator,omitempty" yaml:"configMapGenerator,omitempty"`
 	// SecretGenerator is a list of secrets to generate from
 	// local data (one secret per list item).
 	// The resulting resource is a normal operand, subject to
 	// name prefixing, patching, etc.  By default, the name of
 	// the map will have a suffix hash generated from its contents.
 	SecretGenerator []SecretArgs `json:"secretGenerator,omitempty" yaml:"secretGenerator,omitempty"`
 	// GeneratorOptions modify behavior of all ConfigMap and Secret generators.
 	GeneratorOptions *GeneratorOptions `json:"generatorOptions,omitempty" yaml:"generatorOptions,omitempty"`
 	// Configurations is a list of transformer configuration files
 	Configurations []string `json:"configurations,omitempty" yaml:"configurations,omitempty"`
 	// Generators is a list of files containing custom generators
 	Generators []string `json:"generators,omitempty" yaml:"generators,omitempty"`
 	// Transformers is a list of files containing transformers
 	Transformers []string `json:"transformers,omitempty" yaml:"transformers,omitempty"`
 	// Inventory appends an object that contains the record
 	// of all other objects, which can be used in apply, prune and delete
 	Inventory *Inventory `json:"inventory,omitempty" yaml:"inventory,omitempty"`
 }
 // FixKustomizationPostUnmarshalling fixes things
 // like empty fields that should not be empty, or
 // moving content of deprecated fields to newer
 // fields.
 func (k *Kustomization) FixKustomizationPostUnmarshalling() {
 	if k.APIVersion == "" {
 		k.APIVersion = KustomizationVersion
 	}
 	if k.Kind == "" {
 		k.Kind = KustomizationKind
 	}
 	for _, b := range k.Bases {
 		k.Resources = append(k.Resources, b)
 	}
 	k.Bases = nil
 }
 func (k *Kustomization) EnforceFields() []string {
 	var errs []string
 	if k.APIVersion != "" && k.APIVersion != KustomizationVersion {
 		errs = append(errs, "apiVersion should be "+KustomizationVersion)
 	}
 	if k.Kind != "" && k.Kind != KustomizationKind {
 		errs = append(errs, "kind should be "+KustomizationKind)
 	}
 	return errs
 }
--- a/api/types/kvpairsources.go
+++ b/api/types/kvpairsources.go
@@ -1,31 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // KvPairSources defines places to obtain key value pairs.
 type KvPairSources struct {
 	// LiteralSources is a list of literal
 	// pair sources. Each literal source should
 	// be a key and literal value, e.g. `key=value`
 	LiteralSources []string `json:"literals,omitempty" yaml:"literals,omitempty"`
 	// FileSources is a list of file "sources" to
 	// use in creating a list of key, value pairs.
 	// A source takes the form:  [{key}=]{path}
 	// If the "key=" part is missing, the key is the
 	// path's basename. If they "key=" part is present,
 	// it becomes the key (replacing the basename).
 	// In either case, the value is the file contents.
 	// Specifying a directory will iterate each named
 	// file in the directory whose basename is a
 	// valid configmap key.
 	FileSources []string `json:"files,omitempty" yaml:"files,omitempty"`
 	// EnvSources is a list of file paths.
 	// The contents of each file should be one
 	// key=value pair per line, e.g. a Docker
 	// or npm ".env" file or a ".ini" file
 	// (wikipedia.org/wiki/INI_file)
 	EnvSources []string `json:"envs,omitempty" yaml:"envs,omitempty"`
 }
--- a/api/types/objectmeta.go
+++ b/api/types/objectmeta.go
@@ -1,11 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // ObjectMeta partially copies apimachinery/pkg/apis/meta/v1.ObjectMeta
 // No need for a direct dependence; the fields are stable.
 type ObjectMeta struct {
 	Name      string `json:"name,omitempty" yaml:"name,omitempty"`
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 }
--- a/api/types/pair.go
+++ b/api/types/pair.go
@@ -1,10 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // Pair is a key value pair.
 type Pair struct {
 	Key   string
 	Value string
 }
--- a/api/types/patch.go
+++ b/api/types/patch.go
@@ -1,19 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // Patch represent either a Strategic Merge Patch or a JSON patch
 // and its targets.
 // The content of the patch can either be from a file
 // or from an inline string.
 type Patch struct {
 	// Path is a relative file path to the patch file.
 	Path string `json:"path,omitempty" yaml:"path,omitempty"`
 	// Patch is the content of a patch.
 	Patch string `json:"patch,omitempty" yaml:"patch,omitempty"`
 	// Target points to the resources that the patch is applied to
 	Target *Selector `json:"target,omitempty" yaml:"target,omitempty"`
 }
--- a/api/types/patchjson6902.go
+++ b/api/types/patchjson6902.go
@@ -1,21 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // PatchJson6902 represents a json patch for an object
 // with format documented https://tools.ietf.org/html/rfc6902.
 type PatchJson6902 struct {
 	// PatchTarget refers to a Kubernetes object that the json patch will be
 	// applied to. It must refer to a Kubernetes resource under the
 	// purview of this kustomization. PatchTarget should use the
 	// raw name of the object (the name specified in its YAML,
 	// before addition of a namePrefix and a nameSuffix).
 	Target *PatchTarget `json:"target" yaml:"target"`
 	// relative file path for a json patch file inside a kustomization
 	Path string `json:"path,omitempty" yaml:"path,omitempty"`
 	// inline patch string
 	Patch string `json:"patch,omitempty" yaml:"patch,omitempty"`
 }
--- a/api/types/patchstrategicmerge.go
+++ b/api/types/patchstrategicmerge.go
@@ -1,9 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // PatchStrategicMerge represents a relative path to a
 // stategic merge patch with the format
 // https://github.com/kubernetes/community/blob/master/contributors/devel/strategic-merge-patch.md
 type PatchStrategicMerge string
--- a/api/types/patchtarget.go
+++ b/api/types/patchtarget.go
@@ -1,15 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 import (
 	"sigs.k8s.io/kustomize/api/resid"
 )
 // PatchTarget represents the kubernetes object that the patch is applied to
 type PatchTarget struct {
 	resid.Gvk `json:",inline,omitempty" yaml:",inline,omitempty"`
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 	Name      string `json:"name" yaml:"name"`
 }
--- a/api/types/pluginconfig.go
+++ b/api/types/pluginconfig.go
@@ -1,16 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // PluginConfig holds plugin configuration.
 type PluginConfig struct {
 	// DirectoryPath is an absolute path to a
 	// directory containing kustomize plugins.
 	// This directory may contain subdirectories
 	// further categorizing plugins.
 	DirectoryPath string
 	// Enabled is true if plugins are enabled.
 	Enabled bool
 }
--- a/api/types/replica.go
+++ b/api/types/replica.go
@@ -1,16 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // Replica specifies a modification to a replica config.
 // The number of replicas of a resource whose name matches will be set to count.
 // This struct is used by the ReplicaCountTransform, and is meant to supplement
 // the existing patch functionality with a simpler syntax for replica configuration.
 type Replica struct {
 	// The name of the resource to change the replica count
 	Name string `json:"name,omitempty" yaml:"name,omitempty"`
 	// The number of replicas required.
 	Count int64 `json:"count" yaml:"count"`
 }
--- a/api/types/secretargs.go
+++ b/api/types/secretargs.go
@@ -1,19 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // SecretArgs contains the metadata of how to generate a secret.
 type SecretArgs struct {
 	// GeneratorArgs for the secret.
 	GeneratorArgs `json:",inline,omitempty" yaml:",inline,omitempty"`
 	// Type of the secret.
 	//
 	// This is the same field as the secret type field in v1/Secret:
 	// It can be "Opaque" (default), or "kubernetes.io/tls".
 	//
 	// If type is "kubernetes.io/tls", then "literals" or "files" must have exactly two
 	// keys: "tls.key" and "tls.crt"
 	Type string `json:"type,omitempty" yaml:"type,omitempty"`
 }
--- a/api/types/selector.go
+++ b/api/types/selector.go
@@ -1,27 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 import (
 	"sigs.k8s.io/kustomize/api/resid"
 )
 // Selector specifies a set of resources.
 // Any resource that matches intersection of all conditions
 // is included in this set.
 type Selector struct {
 	resid.Gvk `json:",inline,omitempty" yaml:",inline,omitempty"`
 	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
 	Name      string `json:"name,omitempty" yaml:"name,omitempty"`
 	// AnnotationSelector is a string that follows the label selection expression
 	// https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
 	// It matches with the resource annotations.
 	AnnotationSelector string `json:"annotationSelector,omitempty" yaml:"annotationSelector,omitempty"`
 	// LabelSelector is a string that follows the label selection expression
 	// https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#api
 	// It matches with the resource labels.
 	LabelSelector string `json:"labelSelector,omitempty" yaml:"labelSelector,omitempty"`
 }
--- a/api/types/typemeta.go
+++ b/api/types/typemeta.go
@@ -1,11 +0,0 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 package types
 // TypeMeta partially copies apimachinery/pkg/apis/meta/v1.TypeMeta
 // No need for a direct dependence; the fields are stable.
 type TypeMeta struct {
 	Kind       string `json:"kind,omitempty" yaml:"kind,omitempty"`
 	APIVersion string `json:"apiVersion,omitempty" yaml:"apiVersion,omitempty"`
 }
--- a/cmd/kustomize/main.go
+++ b/cmd/kustomize/main.go
@@ -1,13 +1,12 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
 // The kustomize CLI.
 package main
 import (
 	"os"
-	"sigs.k8s.io/kustomize/kustomize/v3/internal/commands"
+	"sigs.k8s.io/kustomize/v3/pkg/commands"
 )
 func main() {
--- a/cmd/pluginator/main.go
+++ b/cmd/pluginator/main.go
@@ -1,7 +1,7 @@
 // Copyright 2019 The Kubernetes Authors.
 // SPDX-License-Identifier: Apache-2.0
-// A code generator. See /plugin/doc.go for an explanation.
+// See /plugin/doc.go for an explanation.
 package main
 import (
@@ -12,22 +12,10 @@ import (
 	"path/filepath"
 	"strings"
-	"sigs.k8s.io/kustomize/api/pgmconfig"
+	"sigs.k8s.io/kustomize/v3/pkg/pgmconfig"
-	"sigs.k8s.io/kustomize/api/plugins/config"
+	"sigs.k8s.io/kustomize/v3/pkg/plugins"
 	"sigs.k8s.io/kustomize/api/provenance"
 )
 //go:generate stringer -type=pluginType
 type pluginType int
 const (
 	unknown pluginType = iota
 	Transformer
 	Generator
 )
 const packageForGeneratedCode = "builtins"
 func main() {
 	root := inputFileRoot()
 	file, err := os.Open(root + ".go")
@@ -46,51 +34,29 @@ func main() {
 		fmt.Sprintf(
 			"// Code generated by pluginator on %s; DO NOT EDIT.",
 			root))
-	w.write(
+	w.write("package builtin")
 		fmt.Sprintf(
 			"// pluginator %+v\n", provenance.GetProvenance()))
 	w.write("\n")
 	w.write("package " + packageForGeneratedCode)
 	pType := unknown
 	for scanner.Scan() {
 		l := scanner.Text()
 		if strings.HasPrefix(l, "//go:generate") {
 			continue
 		}
-		if strings.HasPrefix(l, "//noinspection") {
+		if l == "var "+plugins.PluginSymbol+" plugin" {
 			w.write("func New" + root + "Plugin() *" + root + "Plugin {")
 			w.write("  return &" + root + "Plugin{}")
 			w.write("}")
 			continue
 		}
 		if l == "var "+config.PluginSymbol+" plugin" {
 			continue
 		}
 		if strings.Contains(l, " Transform(") {
 			if pType != unknown {
 				log.Fatal("unexpected Transform(")
 			}
 			pType = Transformer
 		} else if strings.Contains(l, " Generate(") {
 			if pType != unknown {
 				log.Fatal("unexpected Generate(")
 			}
 			pType = Generator
 		}
 		w.write(l)
 	}
 	if err := scanner.Err(); err != nil {
 		log.Fatal(err)
 	}
 	w.write("")
 	w.write("func New" + root + "Plugin() resmap." + pType.String() + "Plugin {")
 	w.write("  return &" + root + "Plugin{}")
 	w.write("}")
 }
 func inputFileRoot() string {
 	n := os.Getenv("GOFILE")
 	if !strings.HasSuffix(n, ".go") {
 		log.Printf("%+v\n", provenance.GetProvenance())
 		log.Fatalf("expecting .go suffix on %s", n)
 	}
 	return n[:len(n)-len(".go")]
@@ -126,7 +92,8 @@ func makeOutputFileName(root string) string {
 		"src",
 		pgmconfig.DomainName,
 		pgmconfig.ProgramName,
-		"api", "plugins", packageForGeneratedCode,
+		pgmconfig.PluginRoot,
 		"builtin",
 		root+".go")
 }
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -28,31 +28,3 @@ To disable this, use v3, and the `load_restrictor` flag:
 ```
 kustomize build --load_restrictor none $target
 ```
 ## Some field is not transformed by kustomize
 Example: [#1319](https://github.com/kubernetes-sigs/kustomize/issues/1319), [#1322](https://github.com/kubernetes-sigs/kustomize/issues/1322), [#1347](https://github.com/kubernetes-sigs/kustomize/issues/1347) and etc.
 The fields transformed by kustomize is configured explicitly in [defaultconfig](https://github.com/kubernetes-sigs/kustomize/tree/master/pkg/transformers/config/defaultconfig). The configuration itself can be customized by including `configurations` in `kustomization.yaml`, e.g.
 ```yaml
 apiVersion: kustomize.config.k8s.io/v1beta1
 kind: Kustomization
 configurations:
 - kustomizeconfig.yaml
 ```
 The configuration directive allows customization of the following transformers:
 ```yaml
 commonAnnotations: []
 commonLabels: []
 nameprefix: []
 namespace: []
 varreference: []
 namereference: []
 images: []
 replicas: []
 ```
 To persist the changes to default configuration, submit a PR like [#1338](https://github.com/kubernetes-sigs/kustomize/pull/1338), [#1348](https://github.com/kubernetes-sigs/kustomize/pull/1348) and etc.
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -8,61 +8,26 @@ are available on the [release page].
 Or...
-## Quickly curl the latest binary
+## Quickly curl the latest
 ```
-# pick one
+opsys=linux  # or darwin, or windows
 opsys=darwin
 opsys=windows
 opsys=linux
 curl -s https://api.github.com/repos/kubernetes-sigs/kustomize/releases/latest |\
  grep browser_download |\
  grep $opsys |\
  cut -d '"' -f 4 |\
  xargs curl -O -L
-tar xzf ./kustomize_v*_${opsys}_amd64.tar.gz
+mv kustomize_*_${opsys}_amd64 kustomize
-./kustomize version
+chmod u+x kustomize
 ```
 ## Try `go`
 This method is more to show off how the `go` tool works,
 than for any practical purpose.  A kustomize developer should
 clone the repo (see next section), and CI/CD scripts should 
 download a specific ready-to-run executable rather than
 rely on the `go` tool.
 Install the latest kustomize binary in the v3 series to `$GOPATH/bin`:
 ```
 go install sigs.k8s.io/kustomize/kustomize/v3
 ```
-Install a specific version:
+## Install from the HEAD of master branch
 Requires [Go] v1.12 or higher:
 <!-- @installkustomize @test -->
 ```
-go get sigs.k8s.io/kustomize/kustomize/v3@v3.3.0
+go install sigs.k8s.io/kustomize/v3/cmd/kustomize
 ```
 ## Build the kustomize CLI from local source
 ```
 # Need go 1.13 or higher
 unset GOPATH
 # see https://golang.org/doc/go1.13#modules
 unset GO111MODULES
 # clone the repo
 git clone git@github.com:kubernetes-sigs/kustomize.git
 # get into the repo root
 cd kustomize
 # Optionally checkout a particular tag if you don't
 # want to build at head
 git checkout kustomize/v3.2.3
 # build the binary
 (cd kustomize; go install .)
 # run it
 ~/go/bin/kustomize version
 ```
 ### Other methods
--- a/docs/README.md
+++ b/docs/README.md
@@ -23,24 +23,7 @@ English | [简体中文](zh/README.md)
 ## Release notes
- * [kustomize/3.2.2](https://github.com/kubernetes-sigs/kustomize/releases/tag/kustomize%2Fv3.2.2) - kustomize CLI
+ * [3.0](v3.0.0.md) - Late June 2019.  Plugin developer release.
   moved to depend on kustomize Go API [3.3.0](v3.3.0.md).
 * [API 3.3.0](v3.3.0.md) - First release of the kustomize Go API
   in a module excluding the `kustomize` CLI.  From here on,
   the CLI and API will release independently.
 * [kustomize/3.2.1](https://github.com/kubernetes-sigs/kustomize/releases/tag/kustomize%2Fv3.2.1) - Patch release
   of `kustomize` CLI in its own module,
   depending on Go API release [3.2.0](v3.2.0.md).
 * [3.2.0](v3.2.0.md) - TODO(jingfang)
 * [3.1.1](v3.1.0.md) - TODO(jingfang)
 * [3.1](v3.1.0.md) - Late July 2019. Extended patches and improved resource matching.
 * [3.0](v3.0.0.md) - Late June 2019. Plugin developer release.
 * [2.1](v2.1.0.md) - 18 June 2019.  Plugins, ordered resources, etc.
--- a/docs/authoriing.md
+++ b/docs/authoriing.md
@@ -1,37 +0,0 @@
 # kustomization authoring
 kustomize provides sub-commands for managing the contents of a kustomization file from the command line.
 ## kustomize create
 The `kustomize create` command will create a new kustomization in the current directory.
 When run without any flags the command will create an empty `kustomization.yaml` file that can then be updated manually or with the `kustomize edit` sub-commands.
 ```
 kustomize create --namespace=myapp --resources=deployment.yaml,service.yaml --label=app=myapp
 ```
 ### Detecting resources
 > NOTE: Resource detection will not follow symlinks.
 Flags:
      --annotation string   Add one or more common annotations.
      --autodetect          Search for kubernetes resources in the current directory to be added to the kustomization file.
  -h, --help                help for create
      --label string        Add one or more common labels.
      --nameprefix string   Sets the value of the namePrefix field in the kustomization file.
      --namespace string    Set the value of the namespace field in the customization file.
      --namesuffix string   Sets the value of the nameSuffix field in the kustomization file.
      --recursive           Enable recursive directory searching for resource auto-detection.
      --resources string    Name of a file containing a file to add to the kustomization file.
 ## kustomize edit
 With an existing kustomization file the `kustomize edit` command 
 * add
 * set
 * remove
 * fix
--- a/docs/fields.md
+++ b/docs/fields.md
@@ -1,19 +1,5 @@
 # Kustomization File Fields
 [field-name-namespace]: plugins/builtins.md#field-name-namespace
 [field-name-images]: plugins/builtins.md#field-name-images
 [field-name-namePrefix]: plugins/builtins.md#field-name-prefix
 [field-name-nameSuffix]: plugins/builtins.md#field-name-prefix
 [field-name-patches]: plugins/builtins.md#field-name-patches
 [field-name-patchesStrategicMerge]: plugins/builtins.md#field-name-patchesStrategicMerge
 [field-name-patchesJson6902]: plugins/builtins.md#field-name-patchesJson6902
 [field-name-replicas]: plugins/builtins.md#field-name-replicas
 [field-name-secretGenerator]: plugins/builtins.md#field-name-secretGenerator
 [field-name-commonLabels]: plugins/builtins.md#field-name-commonLabels
 [field-name-commonAnnotations]: plugins/builtins.md#field-name-commonAnnotations
 [field-name-configMapGenerator]: plugins/builtins.md#field-name-configMapGenerator
 An explanation of the fields in a [kustomization.yaml](glossary.md#kustomization) file.
@@ -52,7 +38,6 @@ What transformations (customizations) should be applied?
 | [namePrefix](#nameprefix) | string | Prepends value to the names of all resources |
 | [nameSuffix](#namesuffix) | string | The value is appended to the names of all resources. |
 | [replicas](#replicas) | list | Replicas modifies the number of replicas of a resource. |
 | [patches](#patches) | list | Each entry should resolve to a patch that can be applied to multiple targets. |
 |[patchesStrategicMerge](#patchesstrategicmerge)| list |Each entry in this list should resolve to a partial or complete resource definition file.|
 |[patchesJson6902](#patchesjson6902)| list  |Each entry in this list should resolve to a kubernetes object and a JSON patch that will be applied to the object.|
 |[transformers](#transformers)|list|[plugin](plugins) configuration files|
@@ -79,7 +64,7 @@ apiVersion: kustomize.config.k8s.io/v1beta1
 ### bases
-_The `bases` field was deprecated in v2.1.0._
+The `bases` field was deprecated in v2.1.0.
 Move entries into the [resources](#resources)
 field.  This allows bases - which are still a
@@ -87,13 +72,51 @@ field.  This allows bases - which are still a
 ordered relative to other input resources.
 ### commonLabels
-See [field-name-commonLabels].
+
 Adds labels to all resources and selectors
 ```
 commonLabels:
  someName: someValue
  owner: alice
  app: bingo
 ```
 ### commonAnnotations
-See [field-name-commonAnnotations].
+
 Adds annotions (non-identifying metadata) to add
 all resources. Like labels, these are key value
 pairs.
 ```
 commonAnnotations:
  oncallPager: 800-555-1212
 ```
 ### configMapGenerator
-See [field-name-configMapGenerator].
+
 Each entry in this list results in the creation of
 one ConfigMap resource (it's a generator of n maps).
 The example below creates two ConfigMaps. One with the
 names and contents of the given files, the other with
 key/value as data.
 Each configMapGenerator item accepts a parameter of
 `behavior: [create|replace|merge]`.
 This allows an overlay to modify or
 replace an existing configMap from the parent.
 ```
 configMapGenerator:
 - name: myJavaServerProps
  files:
  - application.properties
  - more.properties
 - name: myJavaServerEnvVars
  literals:	
  - JAVA_HOME=/opt/java/jdk
  - JAVA_TOOL_OPTIONS=-agentlib:hprof
 ```
 ### crds
@@ -120,7 +143,9 @@ The annotations can be put into openAPI definitions are:
 -  "x-kubernetes-object-ref-kind": "Secret",
 -  "x-kubernetes-object-ref-name-key": "name",
 ```
 crds:
 - crds/typeA.yaml
 - crds/typeB.yaml
@@ -158,7 +183,42 @@ generators:
 ### images
-See [field-name-images].
+Images modify the name, tags and/or digest for images without creating patches.
 E.g. Given this kubernetes Deployment fragment:
 ```
 containers:
 - name: mypostgresdb
   image: postgres:8
 - name: nginxapp
   image: nginx:1.7.9
 - name: myapp
   image: my-demo-app:latest
 - name: alpine-app
   image: alpine:3.7
 ```
 one can change the `image` in the following ways:
 - `postgres:8` to `my-registry/my-postgres:v1`,
 - nginx tag `1.7.9` to `1.8.0`,
 - image name `my-demo-app` to `my-app`,
 - alpine's tag `3.7` to a digest value
 all with the following *kustomization*:
 ```
 images:
 - name: postgres
  newName: my-registry/my-postgres
  newTag: v1
 - name: nginx
  newTag: 1.8.0
 - name: my-demo-app
  newName: my-app
 - name: alpine
  digest: sha256:24a0c4b4a4c0eb97a1aabb8e29f18e917d05abfe1b7a7c07857230879ce7d3d3
 ```
 ### inventory
@@ -172,33 +232,143 @@ If missing, this field's value defaults to
 kind: Kustomization
 ```
 ### namespace
-See [field-name-namespace].
+Adds namespace to all resources
 ```
 namespace: my-namespace
 ```
 ### namePrefix
-See [field-name-namePrefix].
+Prepends value to the names of all resources
 Ex. a deployment named `wordpress` would become `alices-wordpress`
 ```
 namePrefix: alices-
 ```
 ### nameSuffix
-See [field-name-nameSuffix].
+The value is appended to the names of all
 resources.  Ex. A deployment named `wordpress`
 would become `wordpress-v2`.
-### patches
+The suffix is appended before content has if
 resource type is ConfigMap or Secret.
-See [field-name-patches].
+```
 nameSuffix: -v2
 ```
 ### patchesStrategicMerge
-See [field-name-patchesStrategicMerge].
+Each entry in this list should be a relative path
 resolving to a partial or complete resource
 definition file.
 The names in these (possibly partial) resource
 files must match names already loaded via the
 `resources` field.  These entries are used to
 _patch_ (modify) the known resources.
 Small patches that do one thing are best, e.g. modify
 a memory request/limit, change an env var in a
 ConfigMap, etc.  Small patches are easy to review and
 easy to mix together in overlays.
 ```
 patchesStrategicMerge:
 - service_port_8888.yaml
 - deployment_increase_replicas.yaml
 - deployment_increase_memory.yaml
 ```
 ### patchesJson6902
-See [field-name-patchesJson6902].
+Each entry in this list should resolve to
 a kubernetes object and a JSON patch that will be applied
 to the object.
 The JSON patch is documented at https://tools.ietf.org/html/rfc6902
 target field points to a kubernetes object within the same kustomization
 by the object's group, version, kind, name and namespace.
 path field is a relative file path of a JSON patch file.
 The content in this patch file can be either in JSON format as
 ```
 [
   {"op": "add", "path": "/some/new/path", "value": "value"},
   {"op": "replace", "path": "/some/existing/path", "value": "new value"}
 ]
 ```
 or in YAML format as
 ```
 - op: add
  path: /some/new/path
  value: value
 - op: replace
  path: /some/existing/path
  value: new value
 ```
 ```
 patchesJson6902:
 - target:
    version: v1
    kind: Deployment
    name: my-deployment
  path: add_init_container.yaml
 - target:
    version: v1
    kind: Service
    name: my-service
  path: add_service_annotation.yaml
 ```
 ### replicas
-See [field-name-replicas].
+Replicas modified the number of replicas for a resource.
 E.g. Given this kubernetes Deployment fragment:
 ```
 kind: Deployment
 metadata:
  name: deployment-name
 spec:
  replicas: 3
 ```
 one can change the number of replicas to 5
 by adding the following to your kustomization:
 ```
 replicas:
 - name: deployment-name
  count: 5
 ```
 This field accepts a list, so many resources can
 be modified at the same time.
 #### Limitation
 As this declaration does not take in a `kind:` nor a `group:`
 it will match any `group` and `kind` that has a matching name and
 that is one of:
 - `Deployment`
 - `ReplicationController`
 - `ReplicaSet`
 - `StatefulSet`
 For more complex use cases, revert to using a patch.
 ### resources
@@ -236,7 +406,28 @@ must contain a `kustomization.yaml` file.
 ### secretGenerator
-See [field-name-secretGenerator].
+Each entry in this list results in the creation of
 one Secret resource (it's a generator of n secrets).
 ```
 secretGenerator:
 - name: app-tls
  files:
  - secret/tls.cert
  - secret/tls.key
  type: "kubernetes.io/tls"
 - name: app-tls-namespaced
  # you can define a namespace to generate secret in, defaults to: "default"
  namespace: apps
  files:
  - tls.crt=catsecret/tls.cert
  - tls.key=secret/tls.key
  type: "kubernetes.io/tls"
 - name: env_file_secret
  envs:
  - env.txt
  type: Opaque
 ```
 ### vars
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -36,7 +36,6 @@
 [rpm]: https://en.wikipedia.org/wiki/Rpm_(software)
 [strategic-merge]: https://git.k8s.io/community/contributors/devel/sig-api-machinery/strategic-merge-patch.md
 [target]: #target
 [transformer]: #transformer
 [variant]: #variant
 [variants]: #variant
 [workflow]: workflows.md
@@ -377,8 +376,9 @@ value is a list.
 To change this
 default behavior, add a _directive_.  Recognized
-directives in YAML patches are _replace_ (the default)
+directives include _replace_ (the default), _merge_
-and _delete_ (see [these notes][strategic-merge]).
+(avoid replacing a list), _delete_ and a few more
 (see [these notes][strategic-merge]).
 Note that for custom resources, SMPs are treated as
 [json merge patches][JSONMergePatch].
--- a/docs/plugins/README.md
+++ b/docs/plugins/README.md
@@ -223,7 +223,6 @@ provided in the kustomization file).
 [helm chart inflator]: ../../plugin/someteam.example.com/v1/chartinflator
 [bashed config map]: ../../plugin/someteam.example.com/v1/bashedconfigmap
 [sed transformer]: ../../plugin/someteam.example.com/v1/sedtransformer
 [hashicorp go-getter]: ../../plugin/someteam.example.com/v1/gogetter
 #### Examples
@@ -231,7 +230,7 @@ provided in the kustomization file).
 * [bashed config map] -  Super simple configMap generation from bash.
 * [sed transformer] - Define your unstructured edits using a
   plugin like this one.
- * [hashicorp go-getter] - Download kustomize layes and build it to generate resources
+
 A generator plugin accepts nothing on `stdin`, but emits
 generated resources to `stdout`.
@@ -244,46 +243,6 @@ kustomize uses an exec plugin adapter to provide
 marshalled resources on `stdin` and capture
 `stdout` for further processing.
 #### Generator Options
 A generator exec plugin can adjust the generator options for the resources it emits by setting one of the following internal annotations. 
 > NOTE: These annotations are local to kustomize and will not be included in the final output.
 **`kustomize.config.k8s.io/needs-hash`**
 Resources can be marked as needing to be processed by the internal hash transformer by including the `needs-hash` annotation. When set valid values for the annotation are `"true"` and `"false"` which respectively enable or disable hash suffixing for the resource. Omitting the annotation is equivalent to setting the value `"false"`.
 If this annotation is set on a resource not supported by the hash transformer the build will fail.
 Example:
 ```yaml
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: cm-test
  annotations:
    kustomize.config.k8s.io/needs-hash: "true"
 data:
  foo: bar   
 ```
 **`kustomize.config.k8s.io/behavior`**
 The `behavior` annotation will influence how conflicts are handled for resources emitted by the plugin. Valid values include "create", "merge", and "replace" with "create" being the default. 
 Example:
 ```yaml
 apiVersion: v1
 kind: ConfigMap
 metadata:
  name: cm-test
  annotations:
    kustomize.config.k8s.io/behavior: "merge"
 data:
  foo: bar   
 ```
 ### Go plugins
 Be sure to read [Go plugin caveats](goPluginCaveats.md).
@@ -305,8 +264,8 @@ A Go plugin for kustomize looks like this:
 > package main
 >
 > import (
->	"sigs.k8s.io/kustomize/api/ifc"
+>	"sigs.k8s.io/kustomize/v3/pkg/ifc"
->	"sigs.k8s.io/kustomize/api/resmap"
+>	"sigs.k8s.io/kustomize/v3/pkg/resmap"
 >   ...
 > )
 >
--- a/docs/plugins/builtins.md
+++ b/docs/plugins/builtins.md
@@ -1,683 +0,0 @@
 <!-- 
  TODO: Generate this file (or files) from
        data in directories under plugin/builtin.
        This file too hard to maintain distinctly
        from what's going on in those directories.
        We could expand pluginator to do this, since
        it already scans the relevant files in the
        relevant directory to generate the static
        factory methods for plugins.
 -->
 # Builtin Plugins
 A list of kustomize's builtin plugins (both
 generators and transformers).
 For each plugin, an example is given for
 * implicitly triggering
 the plugin via a dedicated kustomization
 file field (e.g. the `AnnotationsTransformer` is 
 triggered by the `commonAnnotations` field).
 * explicitly triggering the plugin
 via the `generators` or `transformers` field
 (by providing a config file specifying the
 plugin).
 The former method is convenient but limited in 
 power as most of the plugins arguments must
 be defaulted.  The latter method allows for
 complete plugin argument specification.
 [types.GeneratorOptions]: ../../api/types/generatoroptions.go
 [types.SecretArgs]: ../../api/types/secretargs.go
 [types.ConfigMapArgs]: ../../api/types/configmapargs.go
 [config.FieldSpec]: ../../api/plugins/builtinconfig/fieldspec.go
 [types.ObjectMeta]: ../../api/types/objectmeta.go
 [types.Selector]: ../../api/types/selector.go
 [types.Replica]: ../../api/types/replica.go
 [types.PatchStrategicMerge]: ../../api/types/patchstrategicmerge.go
 [types.PatchTarget]: ../../api/types/patchtarget.go
 [image.Image]: ../../api/types/image.go
 ## _AnnotationTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `commonAnnotations`
 Adds annotions (non-identifying metadata) to add
 all resources. Like labels, these are key value
 pairs.
 ```
 commonAnnotations:
  oncallPager: 800-555-1212
 ```
 ### Usage via plugin
 #### Arguments
 > Annotations map\[string\]string
 >
 > FieldSpecs  \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: AnnotationsTransformer
 > metadata:
 >   name: not-important-to-example
 > annotations:
 >   app: myApp
 >   greeting/morning: a string with blanks
 > fieldSpecs:
 > - path: metadata/annotations
 >   create: true
 > ```
 ## _ConfigMapGenerator_
 ### Usage via `kustomization.yaml`
 #### field name: `configMapGenerator`
 Each entry in this list results in the creation of
 one ConfigMap resource (it's a generator of n maps).
 The example below creates two ConfigMaps. One with the
 names and contents of the given files, the other with
 key/value as data.
 Each configMapGenerator item accepts a parameter of
 `behavior: [create|replace|merge]`.
 This allows an overlay to modify or
 replace an existing configMap from the parent.
 ```
 configMapGenerator:
 - name: my-java-server-props
  files:
  - application.properties
  - more.properties
 - name: my-java-server-env-vars
  literals:	
  - JAVA_HOME=/opt/java/jdk
  - JAVA_TOOL_OPTIONS=-agentlib:hprof
 ```
 It is also possible to
 [define a key](https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/#define-the-key-to-use-when-creating-a-configmap-from-a-file)
 to set a name different than the filename.
 The example below creates a ConfigMap
 with the name of file as `myFileName.ini`
 while the _actual_ filename from which the
 configmap is created is `whatever.ini`.
 ```
 configMapGenerator:
 - name: app-whatever
  files:
  - myFileName.ini=whatever.ini
 ```
 ### Usage via plugin
 #### Arguments
 > [types.GeneratorOptions]
 >
 > [types.ConfigMapArgs]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: ConfigMapGenerator
 > metadata:
 >   name: mymap
 > envs:
 > - devops.env
 > - uxteam.env
 > literals:
 > - FRUIT=apple
 > - VEGETABLE=carrot
 > ```
 ## _ImageTagTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `image`
 Images modify the name, tags and/or digest for images
 without creating patches.  E.g. Given this
 kubernetes Deployment fragment:
 ```
 containers:
 - name: mypostgresdb
  image: postgres:8
 - name: nginxapp
  image: nginx:1.7.9
 - name: myapp
  image: my-demo-app:latest
 - name: alpine-app
  image: alpine:3.7
 ```
 one can change the `image` in the following ways:
 - `postgres:8` to `my-registry/my-postgres:v1`,
 - nginx tag `1.7.9` to `1.8.0`,
 - image name `my-demo-app` to `my-app`,
 - alpine's tag `3.7` to a digest value
 all with the following *kustomization*:
 ```
 images:
 - name: postgres
  newName: my-registry/my-postgres
  newTag: v1
 - name: nginx
  newTag: 1.8.0
 - name: my-demo-app
  newName: my-app
 - name: alpine
  digest: sha256:24a0c4b4a4c0eb97a1aabb8e29f18e917d05abfe1b7a7c07857230879ce7d3d3
 ```
 ### Usage via plugin
 #### Arguments
 > ImageTag   [image.Image]
 >
 > FieldSpecs \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: ImageTagTransformer
 > metadata:
 >   name: not-important-to-example
 > imageTag:
 >   name: nginx
 >   newTag: v2
 > ```
 ## _LabelTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `commonLabels`
 Adds labels to all resources and selectors
 ```
 commonLabels:
  someName: someValue
  owner: alice
  app: bingo
 ```
 ### Usage via plugin
 #### Arguments
 > Labels  map\[string\]string
 >
 > FieldSpecs \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: LabelTransformer
 > metadata:
 >   name: not-important-to-example
 > labels:
 >   app: myApp
 >   env: production
 > fieldSpecs:
 > - path: metadata/labels
 >   create: true
 > ```
 ## _NamespaceTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `namespace`
 Adds namespace to all resources
 ```
 namespace: my-namespace
 ```
 ### Usage via plugin
 #### Arguments
 > [types.ObjectMeta]
 >
 > FieldSpecs \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 >  kind: NamespaceTransformer
 >  metadata:
 >    name: not-important-to-example
 >    namespace: test
 >  fieldSpecs:
 >  - path: metadata/namespace
 >    create: true
 >  - path: subjects
 >    kind: RoleBinding
 >    group: rbac.authorization.k8s.io
 >  - path: subjects
 >    kind: ClusterRoleBinding
 >    group: rbac.authorization.k8s.io
 > ```
 ## _PatchesJson6902_
 ### Usage via `kustomization.yaml`
 #### field name: `patchesJson6902`
 Each entry in this list should resolve to
 a kubernetes object and a JSON patch that will be applied
 to the object.
 The JSON patch is documented at https://tools.ietf.org/html/rfc6902
 target field points to a kubernetes object within the same kustomization
 by the object's group, version, kind, name and namespace.
 path field is a relative file path of a JSON patch file.
 The content in this patch file can be either in JSON format as
 ```
 [
   {"op": "add", "path": "/some/new/path", "value": "value"},
   {"op": "replace", "path": "/some/existing/path", "value": "new value"}
 ]
 ```
 or in YAML format as
 ```
 - op: add
  path: /some/new/path
  value: value
 - op: replace
  path: /some/existing/path
  value: new value
 ```
 ```
 patchesJson6902:
 - target:
    version: v1
    kind: Deployment
    name: my-deployment
  path: add_init_container.yaml
 - target:
    version: v1
    kind: Service
    name: my-service
  path: add_service_annotation.yaml
 ```
 The patch content can be an inline string as well:
 ```
 patchesJson6902:
 - target:
    version: v1
    kind: Deployment
    name: my-deployment
  patch: |-
    - op: add
      path: /some/new/path
      value: value
    - op: replace
      path: /some/existing/path
      value: "new value"
 ```
 ### Usage via plugin
 #### Arguments
 > Target [types.PatchTarget]
 >
 > Path   string
 >
 > JsonOp string
 #### Example
 > ```
 > apiVersion: builtin
 > kind: PatchJson6902Transformer
 > metadata:
 >   name: not-important-to-example
 > target:
 >   group: apps
 >   version: v1
 >   kind: Deployment
 >   name: my-deploy
 > path: jsonpatch.json
 > ```
 ## _PatchesStrategicMerge_
 ### Usage via `kustomization.yaml`
 #### field name: `patchesStrategicMerge`
 Each entry in this list should be either a relative
 file path or an inline content
 resolving to a partial or complete resource
 definition.
 The names in these (possibly partial) resource
 files must match names already loaded via the
 `resources` field.  These entries are used to
 _patch_ (modify) the known resources.
 Small patches that do one thing are best, e.g. modify
 a memory request/limit, change an env var in a
 ConfigMap, etc.  Small patches are easy to review and
 easy to mix together in overlays.
 ```
 patchesStrategicMerge:
 - service_port_8888.yaml
 - deployment_increase_replicas.yaml
 - deployment_increase_memory.yaml
 ```
 The patch content can be a inline string as well.
 ```
 patchesStrategicMerge:
 - |-
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: nginx
  spec:
    template:
      spec:
        containers:
          - name: nginx
            image: nignx:latest
 ```
 Note that kustomize does not support more than one patch
 for the same object that contain a _delete_ directive. To remove
 several fields / slice elements from an object create a single
 patch that performs all the needed deletions.
 ### Usage via plugin
 #### Arguments
 > Paths \[\][types.PatchStrategicMerge]
 >
 > Patches string
 #### Example
 > ```
 > apiVersion: builtin
 > kind: PatchStrategicMergeTransformer
 > metadata:
 >   name: not-important-to-example
 > paths:
 > - patch.yaml
 > ```
 ## _PatchTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `patches`
 Each entry in this list should resolve to an Patch
 object, which includes a patch and a target selector. 
 The patch can be either a strategic merge patch or a
 JSON patch. it can be either a patch file or an inline
 string. The target selects
 resources by group, version, kind, name, namespace,
 labelSelector and annotationSelector. A resource
 which matches all the specified fields is selected
 to apply the patch.
 ```
 patches:
 - path: patch.yaml
  target:
    group: apps
    version: v1
    kind: Deployment
    name: deploy.*
    labelSelector: "env=dev"
    annotationSelector: "zone=west"
 - patch: |-
    - op: replace
      path: /some/existing/path
      value: new value
  target:
    kind: MyKind
    labelSelector: "env=dev"        
 ```
 The `name` and `namespace` fields of the patch target selector are
 automatically anchored regular expressions. This means that the value `myapp`
 is equivalent to `^myapp$`. 
 ### Usage via plugin
 #### Arguments
 > Path string
 >
 > Patch string
 >
 > Target \*[types.Selector] 
 #### Example
 > ```
 > apiVersion: builtin
 > kind: PatchTransformer
 > metadata:
 >   name: not-important-to-example
 > patch: '[{"op": "replace", "path": "/spec/template/spec/containers/0/image", "value": "nginx:latest"}]'
 > target:
 >   name: .*Deploy
 >   kind: Deployment
 > ```
 ## _PrefixSuffixTransformer_
 ### Usage via `kustomization.yaml`
 #### field names: `namePrefix`, `nameSuffix`
 Prepends or postfixes the value to the names
 of all resources.
 E.g. a deployment named `wordpress` could
 become `alices-wordpress` or  `wordpress-v2`
 or `alices-wordpress-v2`. 
 ```
 namePrefix: alices-
 nameSuffix: -v2
 ```
 The suffix is appended before the content hash if
 the resource type is ConfigMap or Secret.
 ### Usage via plugin
 #### Arguments
 > Prefix     string
 >
 > Suffix     string
 >
 > FieldSpecs \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: PrefixSuffixTransformer
 > metadata:
 >   name: not-important-to-example
 > prefix: baked-
 > suffix: -pie
 > fieldSpecs:
 >   - path: metadata/name
 > ```
 ## _ReplicaCountTransformer_
 ### Usage via `kustomization.yaml`
 #### field name: `replicas`
 Replicas modified the number of replicas for a resource.
 E.g. Given this kubernetes Deployment fragment:
 ```
 kind: Deployment
 metadata:
  name: deployment-name
 spec:
  replicas: 3
 ```
 one can change the number of replicas to 5
 by adding the following to your kustomization:
 ```
 replicas:
 - name: deployment-name
  count: 5
 ```
 This field accepts a list, so many resources can
 be modified at the same time.
 As this declaration does not take in a `kind:` nor a `group:`
 it will match any `group` and `kind` that has a matching name and
 that is one of:
 - `Deployment`
 - `ReplicationController`
 - `ReplicaSet`
 - `StatefulSet`
 For more complex use cases, revert to using a patch.
 ### Usage via plugin
 #### Arguments
 > Replica [types.Replica]
 >
 > FieldSpecs \[\][config.FieldSpec]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: ReplicaCountTransformer
 > metadata:
 >   name: not-important-to-example
 > replica:
 >   name: myapp
 >   count: 23
 > fieldSpecs:
 > - path: spec/replicas
 >   create: true
 >   kind: Deployment
 > - path: spec/replicas
 >   create: true
 >   kind: ReplicationController
 > ```
 ## _SecretGenerator_
 ### Usage via `kustomization.yaml`
 #### field name: `secretGenerator`
 Each entry in the argument list
 results in the creation of
 one Secret resource
 (it's a generator of n secrets).
 ```
 secretGenerator:
 - name: app-tls
  files:
  - secret/tls.cert
  - secret/tls.key
  type: "kubernetes.io/tls"
 - name: app-tls-namespaced
  # you can define a namespace to generate
  # a secret in, defaults to: "default"
  namespace: apps
  files:
  - tls.crt=catsecret/tls.cert
  - tls.key=secret/tls.key
  type: "kubernetes.io/tls"
 - name: env_file_secret
  envs:
  - env.txt
  type: Opaque
 ```
 ### Usage via plugin
 #### Arguments
 > [types.ObjectMeta]
 >
 > [types.GeneratorOptions]
 >
 > [types.SecretArgs]
 #### Example
 > ```
 > apiVersion: builtin
 > kind: SecretGenerator
 > metadata:
 >   name: my-secret
 >   namespace: whatever
 > behavior: merge
 > envs:
 > - a.env
 > - b.env
 > files:
 > - obscure=longsecret.txt
 > literals:
 > - FRUIT=apple
 > - VEGETABLE=carrot
 > ```
--- a/docs/plugins/execPluginGuidedExample.md
+++ b/docs/plugins/execPluginGuidedExample.md
@@ -12,7 +12,7 @@ current setup.
 #### requirements
- * linux, git, curl, Go 1.13
+ * linux, git, curl, Go 1.12
 ## Make a place to work
@@ -201,7 +201,7 @@ chmod a+x $MY_PLUGIN_DIR/SillyConfigMapGenerator
 ```
 mkdir -p $DEMO/bin
 gh=https://github.com/kubernetes-sigs/kustomize/releases/download
-url=$gh/v3.0.0/kustomize_3.0.0_linux_amd64
+url=$gh/v3.0.0-pre/kustomize_3.0.0-pre_linux_amd64
 curl -o $DEMO/bin/kustomize -L $url
 chmod u+x $DEMO/bin/kustomize
 ```
@@ -226,3 +226,4 @@ Above, if you had set
 there would be no need to use `XDG_CONFIG_HOME` in the
 _kustomize_ command above.
--- a/docs/plugins/goPluginCaveats.md
+++ b/docs/plugins/goPluginCaveats.md
@@ -52,8 +52,8 @@ kustomize and the plugin_.
 This means a one-time run of
 ```
-# Or whatever is appropriate at time of reading
+GOPATH=${whatever} go get \
-GOPATH=${whatever} GO111MODULE=on go get sigs.k8s.io/kustomize/api
+    sigs.k8s.io/kustomize/cmd/kustomize@${releaseVersion}
 ```
 and then a normal development cycle using
--- a/docs/plugins/goPluginGuidedExample.md
+++ b/docs/plugins/goPluginGuidedExample.md
@@ -1,14 +1,10 @@
 # Go Plugin Guided Example for Linux
 This is a (no reading allowed!) 60 second copy/paste guided
 example.  Full plugin docs [here](README.md).
 [SopsEncodedSecrets repository]: https://github.com/monopole/sopsencodedsecrets
 [Go plugin]: https://golang.org/pkg/plugin
 [Go plugin caveats]: goPluginCaveats.md
 This is a (no reading allowed!) 60 second copy/paste guided
 example.
 Full plugin docs [here](README.md).
 Be sure to read the [Go plugin caveats].
 This demo uses a Go plugin, `SopsEncodedSecrets`,
 that lives in the [sopsencodedsecrets repository].
@@ -21,32 +17,23 @@ current setup.
 #### requirements
-* linux, git, curl, Go 1.13
+ * linux, git, curl, Go 1.12
-
+ * Google cloud (gcloud) install
-For encryption
+ * a Google account (will use Google kms -
-
+   volunteers needed to convert to a GPG example).
 * gpg
 Or
 * Google cloud (gcloud) install
 * a Google account with KMS permission
 ## Make a place to work
-```shell
+```
 # Keeping these separate to avoid cluttering the DEMO dir.
 DEMO=$(mktemp -d)
 tmpGoPath=$(mktemp -d)
 ```
 ## Install kustomize
-Need v3.0.0 for what follows, and you must _compile_
+Need v3.0.0 for what follows:
 it (not download the binary from the release page):
-```shell
+```
-GOPATH=$tmpGoPath go install sigs.k8s.io/kustomize/kustomize
+GOBIN=$DEMO/bin go get sigs.k8s.io/kustomize/v3/cmd/kustomize@v3.0.0-pre
 ```
 ## Make a home for plugins
@@ -67,8 +54,8 @@ The kustomize program reads the config file
 kustomization file), then locates the Go plugin's
 object code at the following location:
-> ```shell
+> ```
-> $XDG_CONFIG_HOME/kustomize/plugin/$apiVersion/$lKind/$kind.so
+> $XGD_CONFIG_HOME/kustomize/plugin/$apiVersion/$lKind/$kind.so
 > ```
 where `lKind` holds the lowercased kind.  The
@@ -87,11 +74,11 @@ left to plugins to find their own config.
 This demo will house the plugin it uses at the
 ephemeral directory
-```shell
+```
 PLUGIN_ROOT=$DEMO/kustomize/plugin
 ```
-and ephemerally set `XDG_CONFIG_HOME` on a command
+and ephemerally set `XGD_CONFIG_HOME` on a command
 line below.
 ### What apiVersion and kind?
@@ -113,7 +100,7 @@ and it lives in the [SopsEncodedSecrets repository].
 Somewhat arbitrarily, we'll chose to install 
 this plugin with
-```shell
+```
 apiVersion=mygenerators
 kind=SopsEncodedSecrets
 ```
@@ -124,7 +111,7 @@ By convention, the ultimate home of the plugin
 code and supplemental data, tests, documentation,
 etc. is the lowercase form of its kind.
-```shell
+```
 lKind=$(echo $kind | awk '{print tolower($0)}')
 ```
@@ -134,7 +121,7 @@ In this case, the repo name matches the lowercase
 kind already, so we just clone the repo and get
 the proper directory name automatically:
-```shell
+```
 mkdir -p $PLUGIN_ROOT/${apiVersion}
 cd $PLUGIN_ROOT/${apiVersion}
 git clone git@github.com:monopole/sopsencodedsecrets.git
@@ -142,7 +129,7 @@ git clone git@github.com:monopole/sopsencodedsecrets.git
 Remember this directory:
-```shell
+```
 MY_PLUGIN_DIR=$PLUGIN_ROOT/${apiVersion}/${lKind}
 ```
@@ -151,16 +138,16 @@ MY_PLUGIN_DIR=$PLUGIN_ROOT/${apiVersion}/${lKind}
 Plugins may come with their own tests.
 This one does, and it hopefully passes:
-```shell
+```
 cd $MY_PLUGIN_DIR
 go test SopsEncodedSecrets_test.go
 ```
 Build the object code for use by kustomize:
-```shell
+```
 cd $MY_PLUGIN_DIR
-GOPATH=$tmpGoPath go build -buildmode plugin -o ${kind}.so ${kind}.go
+go build -buildmode plugin -o ${kind}.so ${kind}.go
 ```
 This step may succeed, but kustomize might
@@ -173,7 +160,7 @@ dependency [skew].
 On load failure
 * be sure to build the plugin with the same
-   version of Go (_go1.13_) on the same `$GOOS`
+   version of Go (_go1.12_) on the same `$GOOS`
   (_linux_) and `$GOARCH` (_amd64_) used to build
   the kustomize being [used in this demo].
@@ -193,11 +180,11 @@ reusable instead of bizarrely woven throughout the
 code as a individual special cases.
 ## Create a kustomization
-
+
 Make a kustomization directory to
 hold all your config:
-```shell
+```
 MYAPP=$DEMO/myapp
 mkdir -p $MYAPP
 ```
@@ -207,13 +194,12 @@ Make a config file for the SopsEncodedSecrets plugin.
 Its `apiVersion` and `kind` allow the plugin to be
 found:
-```shell
+```
 cat <<EOF >$MYAPP/secGenerator.yaml
 apiVersion: ${apiVersion}
 kind: ${kind}
 metadata:
-  name: mySecretGenerator
+  name: forbiddenValues
 name: forbiddenValues
 namespace: production
 file: myEncryptedData.yaml
 keys:
@@ -228,7 +214,7 @@ This plugin expects to find more data in
 Make a kustomization file referencing the plugin
 config:
-```shell
+```
 cat <<EOF >$MYAPP/kustomization.yaml
 commonLabels:
  app: hello
@@ -237,46 +223,31 @@ generators:
 EOF
 ```
-Now generate the real encrypted data.
+Now for the hard part.  Generate the real encrypted data.
 ### Assure you have an encryption tool installed
-We're going to use [sops](https://github.com/mozilla/sops) to encode a file. Choose either GPG or Google Cloud KMS as the secret provider to continue.
+### Assure you have a Google Cloud sops key ring.
-#### GPG
+We're going to use [sops](https://github.com/mozilla/sops) to encode a file.
 Try this:
 ```shell
 gpg --list-keys
 ```
 If it returns a list, presumably you've already created keys. If not, try import test keys from sops for dev.
 ```shell
 curl https://raw.githubusercontent.com/mozilla/sops/master/pgp/sops_functional_tests_key.asc | gpg --import
 SOPS_PGP_FP="1022470DE3F0BC54BC6AB62DE05550BC07FB1A0A"
 ```
 #### Google Cloude KMS
 Try this:
 ```shell
 gcloud kms keys list --location global --keyring sops
 ```
-If it succeeds, presumably you've already created keys and placed them in a keyring called sops. If not, do this:
+If it succeeds, presumably you've already
 created keys and placed them in a keyring called `sops`.
 If not, do this:
-```shell
+```
 gcloud kms keyrings create sops --location global
 gcloud kms keys create sops-key --location global \
    --keyring sops --purpose encryption
 ```
 Extract your keyLocation for use below:
-
+```
 ```shell
 keyLocation=$(\
    gcloud kms keys list --location global --keyring sops |\
    grep GOOGLE | cut -d " " -f1)
@@ -285,73 +256,42 @@ echo $keyLocation
 ### Install `sops`
-```shell
+```
-GOPATH=$tmpGoPath go install go.mozilla.org/sops/cmd/sops
+GOBIN=$DEMO/bin go install go.mozilla.org/sops/cmd/sops
 ```
-### Create data encrypted with your private key
+### Create data encrypted with your Google Cloud key
 Create raw data to encrypt:
-
+```
 ```shell
 cat <<EOF >$MYAPP/myClearData.yaml
 VEGETABLE: carrot
 ROCKET: saturn-v
 FRUIT: apple
 CAR: dymaxion
 EOF
 ```
 Encrypt the data into file the plugin wants to read:
 With PGP
 ```shell
 $tmpGoPath/bin/sops --encrypt \
  --pgp $SOPS_PGP_FP \
  $MYAPP/myClearData.yaml >$MYAPP/myEncryptedData.yaml
 ```
-
+$DEMO/bin/sops --encrypt \
 Or GCP KMS
 ```shell
 $tmpGoPath/bin/sops --encrypt \
  --gcp-kms $keyLocation \
  $MYAPP/myClearData.yaml >$MYAPP/myEncryptedData.yaml
 ```
 Review the files
-```shell
+Review the files
 ```
 tree $DEMO
 ```
 This should look something like:
 > ```shell
 > /tmp/tmp.0kIE9VclPt
 > ├── kustomize
 > │   └── plugin
 > │       └── mygenerators
 > │           └── sopsencodedsecrets
 > │               ├── go.mod
 > │               ├── go.sum
 > │               ├── LICENSE
 > │               ├── README.md
 > │               ├── SopsEncodedSecrets.go
 > │               ├── SopsEncodedSecrets.so
 > │               └── SopsEncodedSecrets_test.go
 > └── myapp
 >     ├── kustomization.yaml
 >     ├── myClearData.yaml
 >     ├── myEncryptedData.yaml
 >     └── secGenerator.yaml
 > ```
 ## Build your app, using the plugin:
-```shell
+```
-XDG_CONFIG_HOME=$DEMO $tmpGoPath/bin/kustomize build --enable_alpha_plugins $MYAPP
+XDG_CONFIG_HOME=$DEMO $DEMO/bin/kustomize build --enable_alpha_plugins $MYAPP
 ```
 This should emit a kubernetes secret, with
@@ -359,9 +299,10 @@ encrypted data for the names `ROCKET` and `CAR`.
 Above, if you had set
-> ```shell
+> ```
 > PLUGIN_ROOT=$HOME/.config/kustomize/plugin
 > ```
 there would be no need to use `XDG_CONFIG_HOME` in the
 _kustomize_ command above.
--- a/docs/v2.1.0.md
+++ b/docs/v2.1.0.md
@@ -223,7 +223,7 @@ normal k8s resources means that one can generate
 or transform a generator or a transformer (see
 [TestTransformerTransformers]).
-[TestTransformerTransformers]: ../api/target/transformerplugin_test.go
+[TestTransformerTransformers]: ../pkg/target/transformerplugin_test.go
 ### `replicas` field
--- a/docs/v3.0.0.md
+++ b/docs/v3.0.0.md
@@ -1,15 +1,18 @@
 # kustomize 3.0.0
 This release is basically [v2.1.0](v2.1.0.md),
-with many post-v2.1.0 bugs fixed (in about 150
+with some post-v2.1.0 bugs fixed and a `v3` in Go
-commits) and a `v3` in Go package paths.
+package paths.
 [plugin]: https://github.com/kubernetes-sigs/kustomize/tree/master/docs/plugins
 The major version increment to `v3` puts a new
 floor on a stable API for [plugin] developers
 (both _Go_ plugin developers and _exec_ plugin
-developers who happen to use Go).
+developers who happen to use Go), to carry them
 through the coming series of minor releases and
 patches.
 ### Why so soon after v2.1.0?
--- a/docs/v3.1.0.md
+++ b/docs/v3.1.0.md
@@ -1,127 +0,0 @@
 # kustomize 3.1.0
 ## Extended patches
 Since this version, Kustomize allows applying one patch to multiple resources. This works for both Strategic Merge Patch and JSON Patch. Take a look at [patch multiple objects](../examples/patchMultipleObjects.md).
 ## Improved Resource Matching
 Multiple improvements have been made to allow the user to leverage "namespace"
 instead/or with "name suffix/prefix" to segregate resources.
 ### Patch resolution improvement
 The following example demonstrates how using the namespace field in the patch definition,
 will let the user define two different patches against two different Deployment having the
 same "deploy1" name but in different namespaces in the same Kustomize context/folder.
 Unless the `namespace:` field has been specified in the kustomization.yaml, no namespace
 value will be handled as Kubernetes `default` namespace.
 ```yaml
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: deploy1
  namespace: main
 spec:
  template:
    spec:
      containers:
      - name: nginx
        env:
        - name: ANOTHERENV
          value: TESTVALUE
 ---
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: deploy1
  namespace: production
 spec:
  template:
    spec:
      containers:
      - name: main
        env:
        - name: ANOTHERENV
          value: PRODVALUE
 ```
 ### Variable resolution improvement
 It is possible to add namespace field to the variable declaration. In the following example,
 two `Service` objects with the same `elasticsearch` name have been declared.
 Specifying the namespace in the objRef of the corresponding varriables, allows Kustomize to
 resovlve thoses variables.
 If the namespace is not specified, Kustomize will handle it has a "wildcard" value.
 Extract of kustomization.yaml:
 ```yaml
 vars:
 - name: elasticsearch-test-protocol
  objref:
    kind: Service
    name: elasticsearch
    namespace: test
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 - name: elasticsearch-dev-protocol
  objref:
    kind: Service
    name: elasticsearch
    namespace: dev
    apiVersion: v1
  fieldref:
    fieldpath: spec.ports[0].protocol
 ```
 ### Simultaneous change of names and namespaces
 Kustomize is now able to deal with simultaneous changes of name and namespace.
 Special attention has been paid the handling of: 
 - ClusterRoleBinding/RoleBinding "subjects" field,
 - ValidatingWebhookConfiguration "webhooks" field.
 The user should be able to use a kustomization.yaml as shown in the example bellow
 even if ClusterRoleBind,RoleBinding and ValidatingWebookConfiguration are part of the
 resources he needs to declare.
 Extract of kustomization.yaml:
 ```yaml
 namePrefix: pfx-
 nameSuffix: -sfx
 namespace: testnamespace
 resources:
 ...
 ```
 ### Resource and Kustomize Context matching.
 Kustomize is now able to support more aggregation patterns.
 If for instance, the top level of kustomization.yaml, is simply
 combining sub-components, (as in the following example), Kustomize has improved
 resource matching capabilities. This removes some of the constraints which were
 present on the utilization of prefix/suffix and namespace transformers in the
 individual components.
 ```yaml
 resources:
 - ../component1
 - ../component2
 - ../component3
 ```
 ## Other improvements
 - Image transformation has been improved. This allows the user to update the sha256 of
  an image with another sha256.
 - Multiple default transformer configuration entries have been added, removing the need for the
  user to add them as part of the `configurations:` section of the kustomization.yaml.
 - `kustomize` help command has been tidied up.
--- a/docs/v3.2.0.md
+++ b/docs/v3.2.0.md
@@ -1,29 +0,0 @@
 # kustomize 3.2.0
 ## Inline Patch
 Since this version, Kustomize allows inline patches in all three of `patchesStrategicMerge`, `patchesJson6902` and `patches`. Take a look at [inline patch](../examples/inlinePatch.md).
 ## New Subcommand
 Since this version, one can create a kustomization.yaml file in a directory through a `create` subcommand.
 Create a new overlay from the base ../base
 ```
 kustomize create --resources ../base
 ```
 Create a new kustomization detecing resources in the current directory
 ```
 kustomize create --autodetect
 ```
 Once can also add all resources in the current directory recursively by
 ```
 kustomize create --autodetect --recursive
 ```
 ### New Example Generator
 A new example generator of using go-getter to download resources is added. Take a look at [go-getter generator](../examples/goGetterGeneratorPlugin.md).
--- a/docs/v3.2.1.md
+++ b/docs/v3.2.1.md
@@ -1,13 +0,0 @@
 # kustomize 3.2.1
 This is a patch release, with no new features from 3.2.0.
 It reflects a change in dependence.
 The kustomize binary is now built as a client, with no special
 consideration, of the set of public packages represented by the Go
 module at [https://github.com/kubernetes-sigs/kustomize].
 kustomize the binary is now a client of the kustomize API
 represented by the public package surface presented by
 `https://github.com/kubernetes-sigs/kustomize/v{whatever}`
--- a/docs/v3.3.0.md
+++ b/docs/v3.3.0.md
@@ -1,114 +0,0 @@
 # kustomize 3.3.0
 [versioning policy documentation]: https://github.com/kubernetes-sigs/kustomize/blob/master/docs/versioningPolicy.md
 [release process documentation]: https://github.com/kubernetes-sigs/kustomize/tree/master/releasing
 ## Summary of changes
 ### First release of the Go API-only module.
 Many of the PRs since the last kustomize release were
 around restructuring the _sigs.k8s.io/kustomize_
 repository into three Go modules instead of just one.
 The reasons for this are detailed in the [versioning
 policy documentation], and what it means for releasing
 is explained in the [release process documentation].
 The tl;dr is that the top level module
 `sigs.k8s.io/kustomize` now defines the kustomize Go
 API, and the _kustomize_ CLI sits below it in an
 independent module `sigs.k8s.io/kustomize/kustomize`.
 The modules release independently, though in practice a
 new release of the kustomize Go API will likely be
 followed quickly by a new release of the `kustomize`
 executable.
 This is a necessary step to creating a much smaller
 kustomize Go API surface that has some hope of
 conforming to semantic versioning and being of some use
 to clients.
 The kustomize CLI will see the same kustomize Go API as
 any other client.
 The new semver-able API will begin with `v4.0.0` (not
 yet released) and be a clean break with `v3` etc.
 ### Change log since v3.2.0
 ```
 3c9d828f - Have kustomize CLI depend on kustomize Go API v3.3.0 (Jeffrey Regan)
 5d800f0b - Merge pull request #1595 from monopole/threeReleases (Jeff Regan)
 4eb2d5bc - Three builders. (Jeffrey Regan)
 988af1ff - Update README.md (Jeff Regan)
 1617183e - Merge pull request #1590 from monopole/releaseProcessUpdate (Kubernetes Prow Robot)
 ee727464 - update release process doc (jregan)
 c9e7dc3b - Merge pull request #1589 from monopole/moreTestsAroundKustFileName (Jeff Regan)
 07e0e46a - improve tests for alternative kustomization file names (Jeffrey Regan)
 404d2d63 - Merge pull request #1587 from monopole/reducePgmconfig (Jeff Regan)
 baa0296a - Reduce size of pgmconfig package (Jeffrey Regan)
 0f665ac1 - Merge pull request #1544 from ptux/add-transformer-href (Jeff Regan)
 14b0a650 - Merge pull request #1581 from monopole/refactorFs (Jeff Regan)
 2d58f8b8 - Break the dep between fs and pgmconfig. (Jeffrey Regan)
 9a43ca53 - Merge pull request #1578 from nlamirault/fix/build-plugins-doc (Jeff Regan)
 5372fc6f - Merge pull request #1579 from monopole/fsPackageCleanup (Jeff Regan)
 86bc3440 - Merge pull request #1513 from nimohunter/fix_empty_list_item (Kubernetes Prow Robot)
 a014f7d4 - Merge pull request #1561 from beautytiger/dev-190925 (Jeff Regan)
 9a94bcb8 - Improve fs package and doc in prep to officially go public (Jeffrey Regan)
 07634ef0 - Merge pull request #1575 from monopole/versioning (Jeff Regan)
 995f88d6 - Update versioning notes. (jregan)
 334a6467 - Fix: documentation link for plugins (Nicolas Lamirault)
 08963ba5 - improve test code coverage in transformers (Guangming Wang)
 326fb689 - Merge pull request #1570 from bzub/1234-go_plugin_doc (Jeff Regan)
 970ce67c - Update goPluginCaveats.md (Jeff Regan)
 98d18930 - Update INSTALL.md (Jeff Regan)
 d89b448c - Fix git tag recovery in cloud build. (Jeff Regan)
 17bf9d32 - Update releasing README. (Jeff Regan)
 a99aff1d - Merge pull request #1571 from monopole/updateCloudBuildProcess (Kubernetes Prow Robot)
 a694ac7b - Update cloud build process for kustomize. (Jeffrey Regan)
 b5b11ef6 - Fix compile kustomize example. (bzub)
 fa1af6f5 - Merge pull request #1473 from richardmarshall/execpluginhash (Jeff Regan)
 9288dec0 - Fix failing BashedConfigMapTest (Jeff Regan)
 1a45dd0b - Merge pull request #1566 from monopole/releaseNotes3.2.1 (Kubernetes Prow Robot)
 592c5acf - docs: Exec plugin generator options (Richard Marshall)
 ac9424fa - tests: Add unit tests for update resource options (Richard Marshall)
 79fbe7c4 - Support resource generator options in exec plugins (Richard Marshall)
 f69d526f - v3.2.1 release notes (Jeff Regan)
 07a95a60 - Merge pull request #1565 from monopole/tweakBinaryDepsBeforeTagging (Jeff Regan)
 032b3857 - Pin the kustomize binary's dependence on kustomize libs. (jregan)
 81062959 - Merge pull request #1564 from monopole/moveKustomizeBinaryToOwnModule (Kubernetes Prow Robot)
 b82a8fd3 - Move the kustomize binary to its own module. (Jeffrey Regan)
 2d0c22d6 - Merge pull request #1562 from keleustes/tools (Kubernetes Prow Robot)
 aa342def - Pin tool versions using go modules (Ian Howell)
 10786ec0 - Merge pull request #1554 from keleustes/readme (Kubernetes Prow Robot)
 7c705687 - Update README.md to include Kubernetes 1.16 (Jerome Brette)
 e8933d97 - Merge pull request #1560 from monopole/precommitTuneup (Jeff Regan)
 9d7b6544 - Make pre-commit more portable and less tricky. (jregan)
 7a0946a9 - Merge pull request #1558 from monopole/dependOnNewPluginatorModule (Jeff Regan)
 def4f045 - Depend on new pluginator location. (Jeffrey Regan)
 2f2408f1 - Merge pull request #1559 from monopole/compressCopyright (Jeff Regan)
 3b9bcc48 - Compress copyright in the commands package. (Jeffrey Regan)
 d0429ff4 - Merge pull request #1557 from monopole/pluginatorModule (Jeff Regan)
 33deefc3 - Copy pluginator to its own module. (Jeffrey Regan)
 9b3de82b - Merge pull request #1506 from Liujingfang1/release (Jeff Regan)
 d217074f - Merge pull request #1550 from keleustes/apiversion (Kubernetes Prow Robot)
 1d90ba7c - Fix typo in apiVersion yaml declaration (Jerome Brette)
 eeeb4c36 - Merge pull request #1547 from keleustes/extensions (Kubernetes Prow Robot)
 b1faa989 - Update Ingress apiVersion to networking.k8s.io/v1beta1 (Jerome Brette)
 d8250c9e - move test case (nimohunter)
 c9500466 - add transformer href (Wang(わん))
 0c32691e - Merge pull request #1537 from jaypipes/gomod-install-note (Kubernetes Prow Robot)
 88b1d627 - Merge pull request #1541 from rtnpro/patch-1 (Jeff Regan)
 aec82066 - Update INSTALL.md (Jeff Regan)
 20c2b53a - Merge pull request #1542 from monopole/tweakFilePathsInTest (Jeff Regan)
 274b5c3b - Tweak file path handling and logging in test. (Jeffrey Regan)
 b1fdaa23 - Fix typo in transformerconfigs README (Ratnadeep Debnath)
 b5d5e70b - empty list or map item return error (nimohunter)
 2e829853 - empty list or map item return error (nimohunter)
 55941f57 - add note about GO111MODULE for source install (Jay Pipes)
 9e226001 - empty list or map item return error (nimohunter)
 77b63f96 - add release note for v3.2.0 (jingfangliu)
 ```
--- a/docs/versioningPolicy.md
+++ b/docs/versioningPolicy.md
@@ -1,140 +1,70 @@
 # Versioning
 Running `kustomize` means one is running a
-particular version of a program (a CLI), using a
+particular version of a program, using a
-particular version of underlying packages (a Go
+particular version of underlying packages, and
-API), and reading a particular version of a
+reading a particular version of a [kustomization]
-[kustomization] file.
+file.
-> If you're having trouble with `go get`, please
+## Program Versioning
 > read  [Go API Versioning](#go-api-versioning)
 > and be patient.
 ## CLI Program Versioning
 The command `kustomize version` prints a three
 field version tag (e.g. `v3.0.0`) that aspires to
 [semantic versioning].
-This notion of semver applies only to the CLI;
+When enough changes have accumulated to
-the command names, their arguments and their flags.
+warrant a new release, a [release process]
 is followed, and the fields in the version
 number are bumped per semver.
-The major version changes when some backward
+## Kustomize packages
 incompatibility appears in how the commands
 behave.
-### Installation
+At the time of writing, the kustomize program and
 the packages it uses (and exports) are in the same
 Go module (see the top level `go.mod` file in the
 repo).
-See the [installation docs](INSTALL.md).
+[trailing major version indicator]: https://github.com/golang/go/wiki/Modules#releasing-modules-v2-or-higher
-## Go API Versioning
+Thus, they share the module's version number, per
 its git tag (e.g. `v3.0.0`), whose major verion
 number matches the [trailing major version
 indicator] in the module name (e.g. the `/v3` in
 `sigs.k8s.io/kustomize/v3`).
-The public methods in the public packages
+The non-internal packages in the Go module
-of module `sigs.k8s.io/kustomize/api` constitute
+`sigs.k8s.io/kustomize/v3`, introduced in
-the _kustomize Go API_.
+[v3.0.0](v3.0.0.md), conform to [semantic
-
+versioning].
 #### Version sigs.k8s.io/kustomize/v3 and earlier
 [import path]: https://github.com/golang/go/wiki/Modules#releasing-modules-v2-or-higher
 In `kustomize/v3` (and preceeding major versions), the
 kustomize program and the API live the same Go
 module at `sigs.k8s.io/kustomize`, at [import path]
 `sigs.k8s.io/kustomize/v3`.
 This has been fine for the CLI, but it presents a
 problem for the Go API.
 [minimal version selection]: https://research.swtch.com/vgo-mvs
 The process around Go modules, in particular the
 notion of [minimal version selection], demands
 that the module respect semver.
 Almost all the code in module
 `sigs.k8s.io/kustomize/v3` is exposed (not in a
 directory named `internal`).  Even a minor
 refactor changing a method name or argument type
 in some deeply buried (but still public) method is
 a backward incompatible change.  As a result, Go
 API semver hasn't been followed.  This was a mistake.
 Some options are
 - continue to ignore Go API semver and stick to
  CLI semver (eliminating the usefullness of
  minimal version selection),
 - obey semver, and increment the module's major
  version number with every release (drastically
  reducing the usefullness of minimal version
  selection - since virtually all releases will
  be major),
 - slow down change in the huge API in favor of
  stability, yet somehow continue to deliver
  features,
 - drastically reduce the API surface, stabilize on
  semver there, and refactor as needed inside
  `internal`.
 The last option seems the most appealing.
 #### The first stable API version is coming
 The first stable API version will launch
 as the Go module
 ```
 sigs.k8s.io/kustomize/api
 ```
 The _kustomize_ program itself (`main.go`
 and CLI specific code) will have moved out of
 `sigs.k8s.io/kustomize` and into the new module
 `sigs.k8s.io/kustomize/kustomize`.  This is a
 submodule in the same repo, and it will retain its
 current notion of semver (e.g. a backward
 incompatible change in command behavior will
 trigger a major version bump).  This module will
 not export packages; it's just home to a `main`
 package.
 The `sigs.k8s.io/kustomize/api` module will
 obey semver with a sustainable public
 surface, informed by current usage.  Clients
 should import packages from this module, i.e.
 from import paths prefixed by
 `sigs.k8s.io/kustomize/api/` at first,
 and later by `sigs.k8s.io/kustomize/api/v2/`.
 The kustomize binary
 itself is an API client requiring this module.
 The clients and API will evolve independently.
 ## Kustomization File Versioning
 At the time of writing (circa release of v2.0.0):
-The kustomization file is a struct that is part of
+- A [kustomization] file is just a YAML file that
-the kustomize Go API (the `sigs.k8s.io/kustomize`
+  can be successfully parsed into a particular Go
-module), but it also evolves as a k8s API object -
+  struct defined in the `kustomize` binary.
-it has an `apiVersion` field containing its
+
-own version number.
+- This struct does not have a version number,
  which is the same as saying that its version
  number matches the program's version number,
  since it's compiled in.
 ### Field Change Policy
 - A field's meaning cannot be changed.
 - A field may be deprecated, then removed.
 - Deprecation means triggering a _minor_ (semver)
-  version bump in the kustomize Go API, and
+  version bump in the program, and
-  defining a migration path in a non-fatal error
+  defining a migration path in a non-fatal
-  message.
+  error message.
 - Removal means triggering a _major_ (semver)
-  version bump in the kustomize Go API, and fatal
+  version bump, and fatal error if field encountered
-  error if field encountered (as with any unknown
+  (as with any unknown field).
  field).  Likewise a change in `apiVersion`.
 ### The `edit fix` Command
@@ -144,12 +74,16 @@ fields, and writes it out again in the latest
 format.
 This is a type version upgrade mechanism that
-works within _major_ API revisions.  There is no
+works within _major_ program revisions.  There is
-downgrade capability, as there's no use case for
+no downgrade capability, as there's no use case
-it (see discussion below).
+for it (see discussion below).
 ### Examples
 At the time of writing, in v1.0.x, there were 12
 minor releases, with backward compatible
 deprecations fixable via `edit fix`.
 With the 2.0.0 release, there were three field
 removals:
@@ -157,11 +91,13 @@ removals:
   introduced, because the latter offers more
   general features for image data manipulation.
   `imageTag` was removed in v2.0.0.
 - `patches` was deprecated and replaced by
   `patchesStrategicMerge` when `patchesJson6902`
   was introduced, to make a clearer
   distinction between patch specification formats.
   `patches` was removed in v2.0.0.
 - `secretGenerator/commands` was removed
   due to security concerns in v2.0.0
   with no deprecation period.
@@ -181,8 +117,10 @@ native type signals:
 - its reliability level (alpha vs beta vs
  generally available),
 - the existence of code to provide default values
  to fields not present in a serialization,
 - the existence of code to provide both forward
  and backward conversion between different
  versions of types.
@@ -204,13 +142,17 @@ For CRDs, there's a [proposal] on how to manage
 versioning (e.g. a remote service can offer type
 defaulting and conversions).
-### Differences
+### Kustomization file versioning
 The critical difference between k8s API versioning
 and kustomization file versioning is
 - A k8s API server is able to go _forward_ and
  _backward_ in versioning, to work with older
  clients, over [some range].
 - The `kustomize edit fix` command only moves
-  _forward_ within a _major_ API
+  _forward_ within a _major_ program
  version.
 At the time of writing, the YAML in a
@@ -229,26 +171,60 @@ the following rules.
 Field names with dedicated meaning in k8s
 (`metadata`, `spec`, `status`, etc.)  aren't used.
 This is enforced via code review.
-#### Default values for k8s `kind` and `apiVersion`
+#### Optional use of k8s `kind` and `apiVersion`
-In `v3` or below, the two [special] k8s
+At the time of writing two [special] k8s
-resource fields [`kind`] and [`apiVersion`] may
+resource fields are allowed, but not required, in
-be omitted from the kustomization file.
+a kustomization file: [`kind`] and [`apiVersion`].
-If either field is present, they both must be.
+If either field is present, they both must be, and
-If present, the value of `kind` must be:
+they must have the following values:
-> ```
+``` yaml
-> kind: Kustomization
+kind: Kustomization
-> ```
+apiVersion: kustomize.config.k8s.io/v1beta1
 ```
-If missing, the value of `apiVersion` defaults to
+They are allowed to exist and have specific values
 in a kustomization file only as a sort of
 domain-squatting behavior for some future API.  A
 kustomize user gains nothing from adding these
 fields to a kustomization file.
-> ```
+### Why not require `kind` and `apiVersion`
-> apiVersion: kustomize.config.k8s.io/v1beta1
+
-> ```
+#### Ease of use and setting proper expectations
 Use cases for a kustomization file don't include a
 server storing muliple k8s kinds and offering
 version downgrades.
 The kustomization file is more akin to a
 `Makefile`.  A kustomize command can either read a
 kustomization file, or it cannot, and in the later
 case will complain as specifically as possible
 about why (e.g. `unknown field Foo`).
 So requiring a `kind` and `apiVersion` would just
 be boilerplate in a user's files, and in all the
 examples and tests.
 Nevertheless, _a user still benefits from a
 versioning policy_ and has a `fix` command to
 upgrade files as needed.
 #### We can change our minds
 When/if the kustomization struct graduates to some
 kind of API status, with an expectation of
 "versionless" storage and downgrade capability,
 whatever it looks like at that moment can be
 locked into `/v1beta1` or `/v1` and the `kind`
 and `apiVersion` fields can be required from that
 moment forward.
 [field change policy]: #field-change-policy
 [some range]: https://kubernetes.io/docs/reference/using-api/deprecation-policy
@@ -256,12 +232,11 @@ If missing, the value of `apiVersion` defaults to
 [beta-level rules]: https://github.com/kubernetes/community/blob/master/contributors/devel/api_changes.md#alpha-beta-and-stable-versions
 [changes]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api_changes.md
 [adapt]: https://github.com/kubernetes-sigs/kustomize/blob/master/pkg/types/kustomization.go#L166
-[special]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#resources
+[special]: https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#resources
 [k8s API]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md
 [conventions]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md
 [release page]: https://github.com/kubernetes-sigs/kustomize/releases
 [release process]: ../releasing/README.md
 [kustomization]: glossary.md#kustomization
-[`kind`]: https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md#types-kinds
+[`kind`]: https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md#types-kinds
 [`apiVersion`]: https://kubernetes.io/docs/concepts/overview/kubernetes-api/#api-versioning
 [semantic versioning]: https://semver.org
--- a/docs/zh/INSTALL.md
+++ b/docs/zh/INSTALL.md
@@ -33,7 +33,7 @@ chmod u+x kustomize
 使用 [Go] v1.10.1 或更高版本安装（如果可以访问 [golang.org]）：
-<!-- @installkustomize @testAgainstLatestRelease -->
+<!-- @installkustomize @test -->
 ```
-go install sigs.k8s.io/kustomize/kustomize
+go install sigs.k8s.io/kustomize/v3/cmd/kustomize
 ```
--- a/docs/zh/README.md
+++ b/docs/zh/README.md
@@ -6,7 +6,7 @@
 * [示例](../../examples) - 各种使用流程和概念的详细演示。
- * [术语表](glossary.md) - 用于消除术语歧义。
+ * [术语表](../glossary.md) - 用于消除术语歧义。
 * [Kustomize 字段](fields.md) - 介绍 [kustomization](../glossary.md#kustomization) 文件中各字段的含义。
@@ -19,8 +19,6 @@
 ## 发行说明
 * [3.1](../v3.1.0.md) - 2019年7月下旬，扩展 patches 和改进的资源匹配。
 * [3.0](../v3.0.0.md) - 2019年6月下旬，插件开发者发布。
 * [2.1](../v2.1.0.md) - 2019年6月18日
--- a/docs/zh/glossary.md
+++ b/docs/zh/glossary.md
@@ -1,308 +0,0 @@
 # 词汇表
 [CRD spec]: https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
 [CRD]: #custom-resource-definition
 [DAM]: #声明式应用程序管理
 [Declarative Application Management]: https://github.com/kubernetes/community/blob/master/contributors/design-proposals/architecture/declarative-application-management.md
 [JSON]: https://www.json.org/
 [JSONPatch]: https://tools.ietf.org/html/rfc6902
 [JSONMergePatch]: https://tools.ietf.org/html/rfc7386
 [Resource]: #resource
 [YAML]: http://www.yaml.org/start.html
 [application]: #application
 [apply]: #apply
 [apt]: https://en.wikipedia.org/wiki/APT_(Debian)
 [base]: #base
 [bases]: #base
 [bespoke]: #bespoke-configuration
 [gitops]: #gitops
 [k8s]: #kubernetes
 [kubernetes]: #kubernetes
 [kustomize]: #kustomize
 [kustomization]: #kustomization
 [kustomizations]: #kustomization
 [off-the-shelf]: #off-the-shelf-configuration
 [overlay]: #overlay
 [overlays]: #overlay
 [patch]: #patch
 [patches]: #patch
 [patchJson6902]: #patchjson6902
 [patchExampleJson6902]: https://github.com/kubernetes-sigs/kustomize/blob/master/examples/jsonpatch.md
 [patchesJson6902]: #patchjson6902
 [proposal]: https://github.com/kubernetes/community/pull/1629
 [rebase]: https://git-scm.com/docs/git-rebase
 [资源]: #资源
 [resources]: #resource
 [root]: #kustomization-root
 [rpm]: https://en.wikipedia.org/wiki/Rpm_(software)
 [strategic-merge]: https://git.k8s.io/community/contributors/devel/sig-api-machinery/strategic-merge-patch.md
 [target]: #target
 [transformer]: #transformer
 [variant]: #variant
 [variants]: #variant
 [workflow]: workflows.md
 ## 应用
 **应用**是为某种目的关联起来的一组 Kubernetes 资源，例如一个前有负载均衡器，后有数据库的 Web 服务器。用标签、命名和元数据将[资源]组织起来，可以进行**添加**或**删除**等操作。
 有提案（[Declarative Application Management]）描述了一种称为应用的新的 Kubernetes 资源。更加正式的描述了这一思路，并在应用程序级别提供了运维和仪表盘的支持。
 [Kustomize] 对 Kubernetes 资源进行配置，其中描述的应用程序资源只是另一种普通的资源。
 ## Apply
 **Apply** 这个动词在 Kubernetes 的上下文中，指的是一个 Kubernetes 命令以及能够对集群施加影响的进程内 [API 端点](https://goo.gl/UbCRuf)。
 用户可以将对集群的运行要求用一组完整的资源列表的形式进行表达，通过 **apply** 命令进行提交。
 集群把新提交的资源和之前提交的状态以及当前的实际状态进行合并，形成新的状态。这就是 Kubernetes 的状态管理过程。
 ## Base
 **Base** 指的是会被其它 [Kustomization] 引用的 [Kustomization]。
 包括 [Overlay] 在内的任何 Kustomization，都可以作为其它 Kustomization 的 Base。
 Base 对引用自己的 Overlay 并无感知。
 Base 和 [Overlay] 可以作为 Git 仓库中的唯一内容，用于简单的 [GitOps] 管理。对仓库的变更可以触发构建、测试以及部署过程。
 ## 定制配置
 **定制**配置是由组织为满足自身需要，在内部创建和管理的 [Kustomization] 和[资源]。
 和**定制配置**关联的 [Workflow] 比关联到通用配置的 [Workflow] 要简单一些，原因是通用配置是共享的，需要周期性的跟踪他人作出的变更。
 ## Custom resource definition
 可以通过定制 CRD ([CRD spec]) 的方式对 Kubernetes API 进行扩展。
 CRD 定义的[资源]是一种全新的资源，可以和 ConfigMap、Deployment 之类的原生资源以相同的方式来使用。
 Kustomize 能够生成自定义资源，但是要完成这个目标，必须给出对应的 CRD，这样才能正确的对这种结构进行处理。
 ## 声明式应用程序管理
 Kustomize 鼓励对声明式应用程序管理（[Declarative Application Management]）的支持，这种方式是一系列 Kubernetes 集群管理的最佳实践。Kustomize 应该可以：
 - 适用于任何配置，例如自有配置、共享配置、无状态、有状态等。
 - 支持通用配置，以及创建变体（例如开发、预发布、生产）。
 - 开放使用原生 Kubernetes API，而不是隐藏它们。
 - 不会给版本控制系统和集成的评审和审计工作造成困难。
 - 用 Unix 的风格和其它工具进行协作。
 - 避免使用模板、领域特定的语言等额外的学习内容。
 ## 生成器
 生成器生成的资源，可以直接使用，也可以输出给转换器（[Transformer]）。
 ## GitOps
 一种 DevOps 或者 CICD 流程，这种流程以 Git 作为唯一的事实，并且在这种事实发生变化时采取措施（例如构建、测试和部署）。
 ## Kustomization
 **Kustomization** 这个词可以指 `kustomization.yaml` 这个文件，更常见的情况是一个包含了 `kustomization.yaml` 及其所有直接引用文件的相对路径（所有不需要 URL 的本地数据）。
 也就是说，如果在 [Kustomize] 的上下文中说到 **Kustomization**，可能是以下的情况之一：
 - 一个叫做 `kustomization.yaml` 的文件。
 - 一个压缩包（包含 YAML 文件以及它的引用文件）。
 - 一个 Git 压缩包。
 - 一个 Git 仓库的 URL。
 一个 Kustomization 文件包含的[字段](fields.md)，分为四个类别：
 - `resources`：待定制的现存[资源]，示例字段：`resources`、`crds`。
 - `generator`：将要创建的**新**资源，示例字段：`configMapGenerator`（传统）、`secretGenerator`（传统）、`generators`（v2.1）
 - `transformer`：对前面提到的新旧资源进行**处理**的方式。示例字段：`namePrefix`、`nameSuffix`、`images`、`commonLabels`、`patchesJson6902` 等。在 v2.1 中还有更多的 `transformer`。
 - `meta`：会对上面几种字段产生影响。示例字段：`vars`、`namespace`、`apiVersion`、`kind` 等。
 ## Kustomization root
 直接包含 `kustomization.yaml` 文件的目录。
 处理 Kustomization 文件时，可能访问到该目录以内或以外的文件。
 像 YAML 资源这样的数据文件，或者用于生成 ConfigMap 或 Secret 的包含 `name=value` 的文本文件，或者用于补丁转换的补丁文件，必须**在这个目录的内部**，需要显式的使用**相对路径**来表达。
 v2.1 中有一个特殊选项 `--load_restrictions none` 能够放宽这个限制，从而让不同的 Kustomization 可以共享补丁文件。
 可以用 URL、绝对路径或者相对路径引用其它的 Kustomization（包含 `kustomization.yaml` 文件的其它目录）。
 如果 `A` Kustomization 依赖 `B` Kustomization，那么：
 - `B` 不能包含 `A`。
 - `B` 不能依赖 `A`，间接依赖也不可以。
 `A` 可以包含 `B`，但是这样的话，最简单的方式可能是让 `A` 直接依赖 `B` 的资源，并去除 `B` 的 `kustomization.yaml` 文件（就是把 `B` 合并到 `A`）。
 通常情况下，`B` 和 `A` 处于同级目录，或者 `B` 放在一个完全独立的 Git 仓库里，可以从任意的 Kustomization 进行引用。
 常见布局大致如下：
 > ```
 > ├── base
 > │   ├── deployment.yaml
 > │   ├── kustomization.yaml
 > │   └── service.yaml
 > └── overlays
 >     ├── dev
 >     │   ├── kustomization.yaml
 >     │   └── patch.yaml
 >     ├── prod
 >     │   ├── kustomization.yaml
 >     │   └── patch.yaml
 >     └── staging
 >         ├── kustomization.yaml
 >         └── patch.yaml
 > ```
 `dev`、`prod` 以及 `staging` 是否依赖于 `base`，要根据 `kustomization.yaml` 具体判断。
 ## Kubernetes
 [Kubernetes](https://kubernetes.io) 是一个开源软件，为容器化应用提供了自动部署、伸缩和管理的能力。
 它经常会被简写为 `k8s`。
 ## Kubernetes 风格的对象
 [必要字段]: https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/#required-fields
 用 YAML 或者 JSON 文件表达一个对象，其中包含一些[必要字段]。`kind` 字段用于标识对象类型，`metadata/name` 字段用于区分实例，`apiVersion` 表示的是版本（如果有多个版本的话）。
 ## Kustomize
 `kustomize` 是一个面向 Kubernetes 的命令行工具，用一种无模板、结构化的的方式为为声明式配置提供定制支持。
 `面向 Kubernetes` 的意思是 Kustomize 对 API 资源、Kubernetes 概念（例如名称、标签、命名空间等）、以及资源补丁是有支持的。
 Kustomize 是 [DAM] 的一个实现。
 ## 通用配置
 通用配置是一种用于共享的 Kustomization 以及资源。
 例如创建一个这样的 Github 仓库：
 > ```
 > github.com/username/someapp/
 >   kustomization.yaml
 >   deployment.yaml
 >   configmap.yaml
 >   README.md
 > ```
 其他人可以 `fork` 这个仓库，并把它们的 Fork `clone` 到本地进行定制。
 用户可以用这个克隆回来的版本作为 [Base]，在此基础上定制 [Overlay] 来满足自身需求。
 ## Overlay
 `Overlay` 是一个 依赖于其它 Kustomization 的 Kustomization。
 Overlay 引用（通过文件路径、URI 或者别的什么方式）的 [Kustomization] 被称为 [Base]。
 Overlay 无法脱离 Base 独立生效。
 Overlay 可以作为其它 Overlay 的 Base。
 通常 Overlay 都是不止一个的，因为实际情况中就需要为单一 Base 创建不同的[变体]，例如 `development`、`QA`、`production` 等。
 总的说来，这些变体使用的资源基本是一致的，只有一些简单的差异，例如 Deployment 的实例数量、特定 Pod 的 CPU 资源、ConfigMap 中的数据源定义等。
 可以这样把配置提交到集群：
 > ```
 >  kustomize build someapp/overlays/staging |\
 >      kubectl apply -f -
 >
 >  kustomize build someapp/overlays/production |\
 >      kubectl apply -f -
 > ```
 对 Base 的使用是隐性的——Overlay 的依赖是指向 Base 的。
 请参考 [root]。
 ## 包
 在 Kustomize 中，`包`是没有意义的，Kustomize 并无意成为 [apt]、[rpm] 那样的传统包管理工具。
 ## Patch
 修改资源的通用指令。
 有两种功能类似但是实现不同的补丁方式：[strategic merge patch](#patchstrategicmerge) 和 [JSON patch](#patchjson6902)。
 ## patchStrategicMerge
 `patchStrategicMerge` 是 [strategic-merge] 风格的补丁（SMP）。
 SMP 看上去像个不完整的 Kubernetes 资源 YAML。SMP 中包含 `TypeMeta` 字段，用于表明这个补丁的目标[资源]的 `group/version/kind/name`，剩余的字段是一个嵌套的结构，用于指定新的字段值，例如镜像标签。
 缺省情况下，SMP 会**替换**目标值。如果目标值是一个字符串，这种行为是合适的，但是如果目标值是个列表，可能就不合适了。
 可以加入 `directive` 来修改这种行为，，可以接受的 `directive` 包括 `replace`（缺省）、`merge`（不替换列表）、`delete` 等（[相关说明][strategic-merge]）。
 注意对自定义资源来说，SMP 会被当作 [json merge patches][JSONMergePatch].
 有趣的事实：所有的资源文件都可以当作 SMP 使用，相同 `group/version/kind/name` 资源中的匹配字段会被替换，其它内容则保持不变。
 ## patchJson6902
 `patchJson6902` 引用一个 Kubernetes 资源，并用 [JSONPatch] 指定了修改这一资源的方法。
 `patchJson6902` 几乎可以做到所有 `patchStrategicMerge` 的功能，但是语法更加简单，参考[示例][patchExampleJson6902]
 ## 插件
 Kustomize 可以使用的一段代码，但是无需编译到 Kustomize 内部，可以作为 Kustomization 的一部分，生成或转换 Kubernetes 资源。
 [插件](../plugins)的细节。
 ## 资源
 在 REST-ful API 的上下文中，资源是 `GET`、`PUT` 或者 `POST` 等 HTTP 操作的目标。Kubernetes 提供了 REST-ful API 界面，用于和客户端进行交互。
 在 Kustomization 的上下文中，资源是一个相对于 [root] 的相对路径，指向 [YAML] 或者 [JSON] 文件，描述了一个 Kubernetes API 对象，例如 Deployment 或者 ConfigMap，或者一个 Kustomization、或者一个指向 Kustomization 的 URL。
 或者说任何定义了[对象](https://kubernetes.io/docs/concepts/overview/working-with-objects/kubernetes-objects/#required-fields)的格式正确的 YAML 文件，其中包含了 `kind` 和 `metadata/name` 字段，都是资源。
 ## Root
 参看 [kustomization root][root].
 ## sub-target / sub-application / sub-package
 不存在 `sub-xxx`，只有 [Base] 和 [Overlay]。
 ## Target
 `target` 是 `kustomize build` 的参数，例如：
 > ```
 >  kustomize build $target
 > ```
 `$target` 必须是一个指向 [Kustomization] 的路径或者 URL。
 要创建用于进行 [Apply] 操作的资源，`target` 中必须包含或者引用所有相关信息。
 [Base] 或者 [Overlay] 都可以作为 `target`。
 ## Transformer
 转换器能够修改资源，或者在 `kustomize build` 的过程中获取资源的信息。
 ## 变体
 在集群中把 [Overlay] 应用到 [Base] 上的产物称为**变体**。
 比如 `staging` 和 `production` 两个 Overlay，都修改了同样的 Base，来创建各自的变体。
 `staging` 变体包含了一组用来保障测试过程的资源，或者一些想要看到生产环境下一个版本的外部用户。
 `production` 变体用于承载生产流量，可能使用大量的副本，分配更多的 CPU 和内存。
--- a/examples/README.md
+++ b/examples/README.md
@@ -2,11 +2,15 @@ English | [简体中文](zh/README.md)
 # Examples
-To run these examples, your `$PATH` must contain `kustomize`.
+These examples assume that `kustomize` is on your `$PATH`.
 See the [installation instructions](../docs/INSTALL.md).
-These examples are [tested](../travis/pre-commit.sh)
+They are covered by [pre-commit](../travis/pre-commit.sh)
-to work with the latest _released_ version of kustomize.
+tests, and should work with HEAD
 <!-- @installkustomize @test -->
 ```
 go get sigs.k8s.io/kustomize/v3/cmd/kustomize
 ```
 Basic Usage
@@ -29,8 +33,6 @@ Basic Usage
  * [json patch](jsonpatch.md) - Apply a json patch in a kustomization    
  * [patch multiple objects](patchMultipleObjects.md) - Apply a patch to multiple objects
 Advanced Usage
 - generator plugins:
@@ -40,8 +42,6 @@ Advanced Usage
   * [secret generation](secretGeneratorPlugin.md) - Generating secrets from a plugin. 
   * [remote sources](goGetterGeneratorPlugin.md) - Generating from remote sources.
 - transformer plugins:
   * [validation transformer](validationTransformer/README.md) -
   validate resources through a transformer
--- a/examples/breakfast.md
+++ b/examples/breakfast.md
@@ -6,14 +6,14 @@
 Define a place to work:
-<!-- @makeWorkplace @testAgainstLatestRelease -->
+<!-- @makeWorkplace @test -->
 ```
 DEMO_HOME=$(mktemp -d)
 ```
 Make a place to put the base breakfast configuration:
-<!-- @baseDir @testAgainstLatestRelease -->
+<!-- @baseDir @test -->
 ```
 mkdir -p $DEMO_HOME/breakfast/base
 ```
@@ -21,7 +21,7 @@ mkdir -p $DEMO_HOME/breakfast/base
 Make a `kustomization` to define what goes into
 breakfast.  This breakfast has coffee and pancakes:
-<!-- @baseKustomization @testAgainstLatestRelease -->
+<!-- @baseKustomization @test -->
 ```
 cat <<EOF >$DEMO_HOME/breakfast/base/kustomization.yaml
 resources:
@@ -34,7 +34,7 @@ Here's a _coffee_ type.  Give it a `kind` and `metdata/name` field
 to conform to [kubernetes API object style]; no other
 file or definition is needed:
-<!-- @coffee @testAgainstLatestRelease -->
+<!-- @coffee @test -->
 ```
 cat <<EOF >$DEMO_HOME/breakfast/base/coffee.yaml
 kind: Coffee
@@ -50,7 +50,7 @@ The `name` field merely distinguishes this instance of
 coffee from others (if there were any).
 Likewise, define _pancakes_:
-<!-- @pancakes @testAgainstLatestRelease -->
+<!-- @pancakes @test -->
 ```
 cat <<EOF >$DEMO_HOME/breakfast/base/pancakes.yaml
 kind: Pancakes
@@ -64,7 +64,7 @@ EOF
 Make a custom [variant] of breakfast for Alice, who
 likes her coffee hot:
-<!-- @aliceOverlay @testAgainstLatestRelease -->
+<!-- @aliceOverlay @test -->
 ```
 mkdir -p $DEMO_HOME/breakfast/overlays/alice
@@ -87,7 +87,7 @@ EOF
 And likewise a [variant] for Bob, who wants _five_ pancakes, with strawberries:
-<!-- @bobOverlay @testAgainstLatestRelease -->
+<!-- @bobOverlay @test -->
 ```
 mkdir -p $DEMO_HOME/breakfast/overlays/bob
@@ -111,14 +111,14 @@ EOF
 One can now generate the configs for Alice’s breakfast:
-<!-- @generateAlice @testAgainstLatestRelease -->
+<!-- @generateAlice @test -->
 ```
 kustomize build $DEMO_HOME/breakfast/overlays/alice
 ```
 Likewise for Bob:
-<!-- @generateBob @testAgainstLatestRelease -->
+<!-- @generateBob @test -->
 ```
 kustomize build $DEMO_HOME/breakfast/overlays/bob
 ```
--- a/examples/combineConfigs.md
+++ b/examples/combineConfigs.md
@@ -128,7 +128,7 @@ defined in the [helloworld] demo.
 It will all live in this work directory:
-<!-- @makeWorkplace @testAgainstLatestRelease -->
+<!-- @makeWorkplace @test -->
 ```
 DEMO_HOME=$(mktemp -d)
 ```
@@ -139,7 +139,7 @@ DEMO_HOME=$(mktemp -d)
 Make a place to put the base configuration:
-<!-- @baseDir @testAgainstLatestRelease -->
+<!-- @baseDir @test -->
 ```
 mkdir -p $DEMO_HOME/base
 ```
@@ -150,7 +150,7 @@ environments. Here we're only defining a java
 properties file, and a `kustomization` file that
 references it.
-<!-- @baseKustomization @testAgainstLatestRelease -->
+<!-- @baseKustomization @test -->
 ```
 cat <<EOF >$DEMO_HOME/base/common.properties
 color=blue
@@ -171,14 +171,14 @@ EOF
 Make an abbreviation for the parent of the overlay
 directories:
-<!-- @overlays @testAgainstLatestRelease -->
+<!-- @overlays @test -->
 ```
 OVERLAYS=$DEMO_HOME/overlays
 ```
 Create the files that define the _development_ overlay:
-<!-- @developmentFiles @testAgainstLatestRelease -->
+<!-- @developmentFiles @test -->
 ```
 mkdir -p $OVERLAYS/development
@@ -206,7 +206,7 @@ EOF
 One can now generate the configMaps for development:
-<!-- @runDev @testAgainstLatestRelease -->
+<!-- @runDev @test -->
 ```
 kustomize build $OVERLAYS/development
 ```
@@ -260,7 +260,7 @@ deletes unused configMaps.
 Next, create the files for the _production_ overlay:
-<!-- @productionFiles @testAgainstLatestRelease -->
+<!-- @productionFiles @test -->
 ```
 mkdir -p $OVERLAYS/production
@@ -287,7 +287,7 @@ EOF
 One can now generate the configMaps for production:
-<!-- @runProd @testAgainstLatestRelease -->
+<!-- @runProd @test -->
 ```
 kustomize build $OVERLAYS/production
 ```
--- a/examples/configGeneration.md
+++ b/examples/configGeneration.md
@@ -15,10 +15,8 @@ Kustomize provides two ways of adding ConfigMap in one `kustomization`, either b
 > configMapGenerator:
 > - name: a-configmap
 >   files:
 >     # configfile is used as key
 >     - configs/configfile
->     # configkey is used as key
+>     - configs/another_configfile
 >     - configkey=configs/another_configfile
 > ```
 The ConfigMaps declared as [resource] are treated the same way as other resources. Kustomize doesn't append any hash to the ConfigMap name. The ConfigMap declared from a ConfigMapGenerator is treated differently. A hash is appended to the name and any change in the ConfigMap will trigger a rolling update.
@@ -28,7 +26,7 @@ In this demo, the same [hello_world](helloWorld/README.md) is used while the Con
 ### Establish base and staging
 Establish the base with a configMapGenerator
-<!-- @establishBase @testAgainstLatestRelease -->
+<!-- @establishBase @test -->
 ```
 DEMO_HOME=$(mktemp -d)
@@ -55,7 +53,7 @@ EOF
 ```
 Establish the staging with a patch applied to the ConfigMap
-<!-- @establishStaging @testAgainstLatestRelease -->
+<!-- @establishStaging @test -->
 ```
 OVERLAYS=$DEMO_HOME/overlays
 mkdir -p $OVERLAYS/staging
@@ -93,7 +91,7 @@ configured with data from a configMap.
 The deployment refers to this map by name:
-<!-- @showDeployment @testAgainstLatestRelease -->
+<!-- @showDeployment @test -->
 ```
 grep -C 2 configMapKeyRef $BASE/deployment.yaml
 ```
@@ -119,7 +117,7 @@ collected](https://github.com/kubernetes-sigs/kustomize/issues/242).
 The _staging_ [variant] here has a configMap [patch]:
-<!-- @showMapPatch @testAgainstLatestRelease -->
+<!-- @showMapPatch @test -->
 ```
 cat $OVERLAYS/staging/map.yaml
 ```
@@ -130,7 +128,7 @@ resource spec.
 The ConfigMap it modifies is declared from a configMapGenerator.
-<!-- @showMapBase @testAgainstLatestRelease -->
+<!-- @showMapBase @test -->
 ```
 grep -C 4 configMapGenerator $BASE/kustomization.yaml
 ```
@@ -143,7 +141,7 @@ _not_ what gets used in the cluster.  By design,
 kustomize modifies names of ConfigMaps declared from ConfigMapGenerator.  To see the names
 ultimately used in the cluster, just run kustomize:
-<!-- @grepStagingName @testAgainstLatestRelease -->
+<!-- @grepStagingName @test -->
 ```
 kustomize build $OVERLAYS/staging |\
    grep -B 8 -A 1 staging-the-map
@@ -161,7 +159,7 @@ The suffix to the configMap name is generated from a
 hash of the maps content - in this case the name suffix
 is _k25m8k5k5m_:
-<!-- @grepStagingHash @testAgainstLatestRelease -->
+<!-- @grepStagingHash @test -->
 ```
 kustomize build $OVERLAYS/staging | grep k25m8k5k5m
 ```
@@ -169,7 +167,7 @@ kustomize build $OVERLAYS/staging | grep k25m8k5k5m
 Now modify the map patch, to change the greeting
 the server will use:
-<!-- @changeMap @testAgainstLatestRelease -->
+<!-- @changeMap @test -->
 ```
 sed -i.bak 's/pineapple/kiwi/' $OVERLAYS/staging/map.yaml
 ```
@@ -183,7 +181,7 @@ kustomize build $OVERLAYS/staging |\
 Run kustomize again to see the new configMap names:
-<!-- @grepStagingName @testAgainstLatestRelease -->
+<!-- @grepStagingName @test -->
 ```
 kustomize build $OVERLAYS/staging |\
    grep -B 8 -A 1 staging-the-map
@@ -194,7 +192,7 @@ in three new names ending in _cd7kdh48fd_ - one in the
 configMap name itself, and two in the deployment that
 uses the map:
-<!-- @countHashes @testAgainstLatestRelease -->
+<!-- @countHashes @test -->
 ```
 test 3 == \
  $(kustomize build $OVERLAYS/staging | grep cd7kdh48fd | wc -l); \
--- a/examples/configureBuiltinPlugin.md
+++ b/examples/configureBuiltinPlugin.md
@@ -1,333 +0,0 @@
 [builtin operations]: ../docs/plugins/builtins.md
 [builtin plugins]: ../docs/plugins/builtins.md
 [plugins]: ../docs/plugins
 [plugin]: ../docs/plugins
 [fields]: ../docs/fields.md
 [fields in a kustomization file]: ../docs/fields.md
 [TransformerConfig]: ../api/plugins/builtinconfig/transformerconfig.go
 [kustomization]: ../docs/glossary.md#kustomization
 # Customizing kustomize
 The [fields in a kustomization file] allow the user to
 specify which resource files to use as input, how to
 _generate_ new resources, and how to _transform_ those
 resources - add labels, patch them, etc.
 These fields are simple (low argument count) directives.
 For example, the `commonAnnotations` field demands only a
 list of _name:value_ pairs.
 If using a field triggers behavior that pleases the user,
 everyone's happy.
 If not, the user can ask for new behavior to be implemented
 in kustomize proper (and wait), or the user can write a
 transformer or generator [plugin].  This latter option
 generally means writing code; a Go plugin, a Go binary,
 a C++ binary, a `bash` script - something.
 There's a third option.  If one merely wants to tweak
 behavior that already exists in kustomize, one may be able
 to do so by just writing some YAML.
 ## Configure the builtin plugins
 All of kustomize's [builtin operations] are implemented 
 and usable as plugins.
 Using the fields is convenient and brief, but necessarily
 specifies only part of the entire plugin specification.  The
 unspecified part is defaulted to what are hopefully
 generally appealing values.
 If, instead, one invokes the plugins directly using the
 `transformers` or `generators` field, one can (indeed
 _must_) specify the entire plugin configuration.
 ## Example: field vs plugin
 Define a place to work:
 <!-- @makeWorkplace @testAgainstLatestRelease -->
 ```
 DEMO_HOME=$(mktemp -d)
 ```
 ### Using the `commonLabels` and `commonAnnotations` fields
 In this simple example, we'll use just two resources: a deployment and a service.
 Define them:
 <!-- @makeRes1 @testAgainstLatestRelease -->
 ```
 cat <<EOF >$DEMO_HOME/deployment.yaml
 apiVersion: apps/v1
 kind: Deployment
 metadata:
  name: deployment
 spec:
  replicas: 10
  template:
    spec:
      containers:
      - name: the-container
        image: monopole/hello:1
 EOF
 ```
 <!-- @makeRes2 @testAgainstLatestRelease -->
 ```
 cat <<EOF >$DEMO_HOME/service.yaml
 apiVersion: v1
 kind: Service
 metadata:
  name: service
 spec:
  type: LoadBalancer
  ports:
  - protocol: TCP
    port: 8666
    targetPort: 8080
 EOF
 ```
 Now make a kustomization file that causes them
 to be read and transformed:
 <!-- @makeKustomization @testAgainstLatestRelease -->
 ```
 cat <<'EOF' >$DEMO_HOME/kustomization.yaml
 namePrefix: hello-
 commonLabels:
  app: hello
 commonAnnotations:
  area: "51"
  greeting: Take me to your leader
 resources:
 - deployment.yaml
 - service.yaml
 EOF
 ```
 And run kustomize:
 <!-- @checkLabel @testAgainstLatestRelease -->
 ```
 kustomize build $DEMO_HOME
 ```
 The output will be something like
 > ```
 > apiVersion: v1
 > kind: Service
 > metadata:
 >   annotations:
 >     area: "51"
 >     greeting: Take me to your leader
 >   labels:
 >     app: hello
 >   name: hello-service
 > spec:
 >   ports:
 >   - port: 8666
 >     protocol: TCP
 >     targetPort: 8080
 >   selector:
 >     app: hello
 >   type: LoadBalancer
 > ---
 > apiVersion: apps/v1
 > kind: Deployment
 > metadata:
 >   annotations:
 >     area: "51"
 >     greeting: Take me to your leader
 >   labels:
 >     app: hello
 >   name: hello-deployment
 > spec:
 >   replicas: 10
 >   selector:
 >     matchLabels:
 >       app: hello
 >   template:
 >     metadata:
 >       annotations:
 >         area: "51"
 >         greeting: Take me to your leader
 >       labels:
 >         app: hello
 >     spec:
 >       containers:
 >       - image: monopole/hello:1
 >         name: the-container
 > ```
 Let's say we are unhappy with this result.
 We only want the annotations
 to be applied down in the pod templates,
 and don't want to see them in the metadata
 for Service or Deployment.
 We like that the label _app: hello_ ended up in
 - Service `spec.selector`
 - Deployment `spec.selector.matchLabels`
 - Deployment `spec.template.metadata.labels`
 as this binds the Service (load balancer) to the pods,
 and the Deployment itself to its own pods -
 but we again don't care to see these labels in
 the metadata for the Service and the Deployment.
 ### Configuring the builtin plugins instead
 To fine tune this, invoke the same transformations
 using the plugin approach.
 Change the kustomization file:
 <!-- @makeKustomization @testAgainstLatestRelease -->
 ```
 cat <<'EOF' >$DEMO_HOME/kustomization.yaml
 namePrefix: hello-
 transformers:
 - myAnnotator.yaml
 - myLabeller.yaml
 resources:
 - deployment.yaml
 - service.yaml
 EOF
 ```
 Then make the two plugin configuration files
 (`myAnnotator.yaml`, `myLabeller.yaml`)
 referred to by the `transformers` field above.
 For details about the fields to specify, see
 the documentation for the [builtin plugins].
 <!-- @makeAnnotatorPluginConfig @testAgainstLatestRelease -->
 ```
 cat <<EOF >$DEMO_HOME/myAnnotator.yaml
 apiVersion: builtin
 kind: AnnotationsTransformer
 metadata:
  name: notImportantHere
 annotations:
  area: 51
  greeting: take me to your leader
 fieldSpecs:
 - kind: Deployment
  path: spec/template/metadata/annotations
  create: true
 EOF
 ```
 <!-- @makeLabelPluginConfig @testAgainstLatestRelease -->
 ```
 cat <<EOF >$DEMO_HOME/myLabeller.yaml
 apiVersion: builtin
 kind: LabelTransformer
 metadata:
  name: notImportantHere
 labels:
  app: hello
 fieldSpecs:
 - kind: Service
  path: spec/selector
  create: true
 - kind: Deployment
  path: spec/selector/matchLabels
  create: true
 - kind: Deployment
  path: spec/template/metadata/labels
  create: true
 EOF
 ```
 Finally, run kustomize again:
 <!-- @checkLabel @testAgainstLatestRelease -->
 ```
 kustomize build $DEMO_HOME
 ```
 The output should resemble the following,
 with fewer labels and annotations.
 > ```
 > apiVersion: v1
 > kind: Service
 > metadata:
 >   name: hello-service
 > spec:
 >   ports:
 >   - port: 8666
 >     protocol: TCP
 >     targetPort: 8080
 >   selector:
 >     app: hello
 >   type: LoadBalancer
 > ---
 > apiVersion: apps/v1
 > kind: Deployment
 > metadata:
 >   name: hello-deployment
 > spec:
 >   replicas: 10
 >   selector:
 >     matchLabels:
 >       app: hello
 >   template:
 >     metadata:
 >       annotations:
 >         area: "51"
 >         greeting: take me to your leader
 >       labels:
 >         app: hello
 >     spec:
 >       containers:
 >       - image: monopole/hello:1
 >         name: the-container
 > ```
 ## The old way to do this
 The original (and still functional) way to customize
 kustomize is to specify a `configurations` field in the
 kustomization file.
 This field, normally omitted because it overrides hardcoded
 data, accepts a list of file path arguments.  The files, in
 turn, specify which fields in which k8s objects should be
 affected by particular builtin transformations.  It's a
 global configuration cutting across transformations, and
 doesn't effect generators at all.
 At `build` time, the configuration files are unmarshalled
 into one instance of [TransformerConfig].  This
 object, _plus_ the field values for `namePrefix`, etc.  are
 fed into the transformation code to build the output.
 The best way to write these custom configuration files is to
 generate the files from the hardcoded values built into
 kustomize via these commands:
 > ```
 > mkdir /tmp/junk
 > kustomize config save -d /tmp/junk
 > ```
 One can then edit those file or files, and specify the
 resulting edited files in a `configurations:`
 field in a kustomization file used in a `build`.
 Using plugins _completely ignores_ both hard coded
 tranformer configuration, and any configuration loaded by
 the `configuration` field.
--- a/examples/generatorOptions.md
+++ b/examples/generatorOptions.md
@@ -13,7 +13,7 @@ DEMO_HOME=$(mktemp -d)
 Create a kustomization and add a ConfigMap generator to it.
-<!-- @createCMGenerator @testAgainstLatestRelease -->
+<!-- @createCMGenerator @test -->
 ```
 cat > $DEMO_HOME/kustomization.yaml << EOF
 configMapGenerator:
@@ -25,7 +25,7 @@ EOF
 ```
 Add following generatorOptions
-<!-- @addGeneratorOptions @testAgainstLatestRelease -->
+<!-- @addGeneratorOptions @test -->
 ```
 cat >> $DEMO_HOME/kustomization.yaml << EOF
 generatorOptions:
@@ -39,7 +39,7 @@ EOF
 Run `kustomize build` and make sure that the generated ConfigMap
 - doesn't have name suffix
-    <!-- @verify @testAgainstLatestRelease -->
+    <!-- @verify @test -->
    ```
    test 1 == \
    $(kustomize build $DEMO_HOME | grep "name: my-configmap$" | wc -l); \
--- a/Show More
+++ b/Show More