cmd/preferredimports/preferredimports.go - third_party/kubernetes - Git at Google

 /*
 Copyright 2019 The Kubernetes Authors.

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
 */

 // verify that all the imports have our preferred alias(es).
 package main

 import (
 	"bytes"
 	"encoding/json"
 	"flag"
 	"fmt"
 	"go/ast"
 	"go/build"
 	"go/format"
 	"go/parser"
 	"go/token"
 	"log"
 	"os"
 	"path/filepath"
 	"regexp"
 	"sort"
 	"strings"

 	"golang.org/x/term"
 )

 var (
 	importAliases = flag.String("import-aliases", "hack/.import-aliases", "json file with import aliases")
 	confirm       = flag.Bool("confirm", false, "update file with the preferred aliases for imports")
 	regex         = flag.String("include-path", "(test/e2e/|test/e2e_node)", "only files with paths matching this regex is touched")
 	isTerminal    = term.IsTerminal(int(os.Stdout.Fd()))
 	logPrefix     = ""
 	aliases       = map[*regexp.Regexp]string{}
 )

 type analyzer struct {
 	fset      *token.FileSet // positions are relative to fset
 	ctx       build.Context
 	failed    bool
 	donePaths map[string]interface{}
 }

 func newAnalyzer() *analyzer {
 	ctx := build.Default
 	ctx.CgoEnabled = true

 	a := &analyzer{
 		fset:      token.NewFileSet(),
 		ctx:       ctx,
 		donePaths: make(map[string]interface{}),
 	}

 	return a
 }

 // collect extracts test metadata from a file.
 func (a *analyzer) collect(dir string) {
 	if _, ok := a.donePaths[dir]; ok {
 		return
 	}
 	a.donePaths[dir] = nil

 	// Create the AST by parsing src.
 	fs, err := parser.ParseDir(a.fset, dir, nil, parser.AllErrors|parser.ParseComments)

 	if err != nil {
 		fmt.Fprintln(os.Stderr, "ERROR(syntax)", logPrefix, err)
 		a.failed = true
 		return
 	}

 	for _, p := range fs {
 		// returns first error, but a.handleError deals with it
 		files := a.filterFiles(p.Files)
 		for _, file := range files {
 			replacements := make(map[string]string)
 			pathToFile := a.fset.File(file.Pos()).Name()
 			for _, imp := range file.Imports {
 				importPath := strings.Replace(imp.Path.Value, "\"", "", -1)
 				pathSegments := strings.Split(importPath, "/")
 				importName := pathSegments[len(pathSegments)-1]
 				if imp.Name != nil {
 					importName = imp.Name.Name
 				}
 				for re, template := range aliases {
 					match := re.FindStringSubmatchIndex(importPath)
 					if match == nil {
 						// No match.
 						continue
 					}
 					if match[0] > 0 || match[1] < len(importPath) {
 						// Not a full match.
 						continue
 					}
 					alias := string(re.ExpandString(nil, template, importPath, match))
 					if alias != importName {
 						if !*confirm {
 							fmt.Fprintf(os.Stderr, "%sERROR wrong alias for import \"%s\" should be %s in file %s\n", logPrefix, importPath, alias, pathToFile)
 							a.failed = true
 						}
 						replacements[importName] = alias
 						if imp.Name != nil {
 							imp.Name.Name = alias
 						} else {
 							imp.Name = ast.NewIdent(alias)
 						}
 					}
 					break
 				}
 			}

 			if len(replacements) > 0 {
 				if *confirm {
 					fmt.Printf("%sReplacing imports with aliases in file %s\n", logPrefix, pathToFile)
 					for key, value := range replacements {
 						renameImportUsages(file, key, value)
 					}
 					ast.SortImports(a.fset, file)
 					var buffer bytes.Buffer
 					if err = format.Node(&buffer, a.fset, file); err != nil {
 						panic(fmt.Sprintf("Error formatting ast node after rewriting import.\n%s\n", err.Error()))
 					}

 					fileInfo, err := os.Stat(pathToFile)
 					if err != nil {
 						panic(fmt.Sprintf("Error stat'ing file: %s\n%s\n", pathToFile, err.Error()))
 					}

 					err = os.WriteFile(pathToFile, buffer.Bytes(), fileInfo.Mode())
 					if err != nil {
 						panic(fmt.Sprintf("Error writing file: %s\n%s\n", pathToFile, err.Error()))
 					}
 				}
 			}
 		}
 	}
 }

 func renameImportUsages(f *ast.File, old, new string) {
 	// use this to avoid renaming the package declaration, eg:
 	//   given: package foo; import foo "bar"; foo.Baz, rename foo->qux
 	//   yield: package foo; import qux "bar"; qux.Baz
 	var pkg *ast.Ident

 	// Rename top-level old to new, both unresolved names
 	// (probably defined in another file) and names that resolve
 	// to a declaration we renamed.
 	ast.Inspect(f, func(node ast.Node) bool {
 		if node == nil {
 			return false
 		}
 		switch id := node.(type) {
 		case *ast.File:
 			pkg = id.Name
 		case *ast.Ident:
 			if pkg != nil && id == pkg {
 				return false
 			}
 			if id.Name == old {
 				id.Name = new
 			}
 		}
 		return true
 	})
 }

 func (a *analyzer) filterFiles(fs map[string]*ast.File) []*ast.File {
 	var files []*ast.File
 	for _, f := range fs {
 		files = append(files, f)
 	}
 	return files
 }

 type collector struct {
 	dirs  []string
 	regex *regexp.Regexp
 }

 // handlePath walks the filesystem recursively, collecting directories,
 // ignoring some unneeded directories (hidden/vendored) that are handled
 // specially later.
 func (c *collector) handlePath(path string, info os.FileInfo, err error) error {
 	if err != nil {
 		return err
 	}
 	if info.IsDir() {
 		// Ignore hidden directories (.git, .cache, etc)
 		if len(path) > 1 && path[0] == '.' ||
 			// OS-specific vendor code tends to be imported by OS-specific
 			// packages. We recursively typecheck imported vendored packages for
 			// each OS, but don't typecheck everything for every OS.
 			path == "vendor" ||
 			path == "_output" ||
 			// This is a weird one. /testdata/ is *mostly* ignored by Go,
 			// and this translates to kubernetes/vendor not working.
 			// edit/record.go doesn't compile without gopkg.in/yaml.v2
 			// in $GOSRC/$GOROOT (both typecheck and the shell script).
 			path == "pkg/kubectl/cmd/testdata/edit" {
 			return filepath.SkipDir
 		}
 		if c.regex.MatchString(path) {
 			c.dirs = append(c.dirs, path)
 		}
 	}
 	return nil
 }

 func main() {
 	flag.Parse()
 	args := flag.Args()

 	if len(args) == 0 {
 		args = append(args, ".")
 	}

 	regex, err := regexp.Compile(*regex)
 	if err != nil {
 		log.Fatalf("Error compiling regex: %v", err)
 	}
 	c := collector{regex: regex}
 	for _, arg := range args {
 		err := filepath.Walk(arg, c.handlePath)
 		if err != nil {
 			log.Fatalf("Error walking: %v", err)
 		}
 	}
 	sort.Strings(c.dirs)

 	if len(*importAliases) > 0 {
 		bytes, err := os.ReadFile(*importAliases)
 		if err != nil {
 			log.Fatalf("Error reading import aliases: %v", err)
 		}
 		var stringAliases map[string]string
 		err = json.Unmarshal(bytes, &stringAliases)
 		if err != nil {
 			log.Fatalf("Error loading aliases: %v", err)
 		}
 		for pattern, name := range stringAliases {
 			re, err := regexp.Compile(pattern)
 			if err != nil {
 				log.Fatalf("Error parsing import path pattern %q as regular expression: %v", pattern, err)
 			}
 			aliases[re] = name
 		}
 	}
 	if isTerminal {
 		logPrefix = "\r" // clear status bar when printing
 	}
 	fmt.Println("checking-imports: ")

 	a := newAnalyzer()
 	for _, dir := range c.dirs {
 		if isTerminal {
 			fmt.Printf("\r\033[0m %-80s", dir)
 		}
 		a.collect(dir)
 	}
 	fmt.Println()
 	if a.failed {
 		os.Exit(1)
 	}
 }
	/*
	Copyright 2019 The Kubernetes Authors.

	Licensed under the Apache License, Version 2.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	*/

	// verify that all the imports have our preferred alias(es).
	package main

	import (
	"bytes"
	"encoding/json"
	"flag"
	"fmt"
	"go/ast"
	"go/build"
	"go/format"
	"go/parser"
	"go/token"
	"log"
	"os"
	"path/filepath"
	"regexp"
	"sort"
	"strings"

	"golang.org/x/term"
	)

	var (
	importAliases = flag.String("import-aliases", "hack/.import-aliases", "json file with import aliases")
	confirm = flag.Bool("confirm", false, "update file with the preferred aliases for imports")
	regex = flag.String("include-path", "(test/e2e/\|test/e2e_node)", "only files with paths matching this regex is touched")
	isTerminal = term.IsTerminal(int(os.Stdout.Fd()))
	logPrefix = ""
	aliases = map[*regexp.Regexp]string{}
	)

	type analyzer struct {
	fset *token.FileSet // positions are relative to fset
	ctx build.Context
	failed bool
	donePaths map[string]interface{}
	}

	func newAnalyzer() *analyzer {
	ctx := build.Default
	ctx.CgoEnabled = true

	a := &analyzer{
	fset: token.NewFileSet(),
	ctx: ctx,
	donePaths: make(map[string]interface{}),
	}

	return a
	}

	// collect extracts test metadata from a file.
	func (a *analyzer) collect(dir string) {
	if _, ok := a.donePaths[dir]; ok {
	return
	}
	a.donePaths[dir] = nil

	// Create the AST by parsing src.
	fs, err := parser.ParseDir(a.fset, dir, nil, parser.AllErrors\|parser.ParseComments)

	if err != nil {
	fmt.Fprintln(os.Stderr, "ERROR(syntax)", logPrefix, err)
	a.failed = true
	return
	}

	for _, p := range fs {
	// returns first error, but a.handleError deals with it
	files := a.filterFiles(p.Files)
	for _, file := range files {
	replacements := make(map[string]string)
	pathToFile := a.fset.File(file.Pos()).Name()
	for _, imp := range file.Imports {
	importPath := strings.Replace(imp.Path.Value, "\"", "", -1)
	pathSegments := strings.Split(importPath, "/")
	importName := pathSegments[len(pathSegments)-1]
	if imp.Name != nil {
	importName = imp.Name.Name
	}
	for re, template := range aliases {
	match := re.FindStringSubmatchIndex(importPath)
	if match == nil {
	// No match.
	continue
	}
	if match[0] > 0 \|\| match[1] < len(importPath) {
	// Not a full match.
	continue
	}
	alias := string(re.ExpandString(nil, template, importPath, match))
	if alias != importName {
	if !*confirm {
	fmt.Fprintf(os.Stderr, "%sERROR wrong alias for import \"%s\" should be %s in file %s\n", logPrefix, importPath, alias, pathToFile)
	a.failed = true
	}
	replacements[importName] = alias
	if imp.Name != nil {
	imp.Name.Name = alias
	} else {
	imp.Name = ast.NewIdent(alias)
	}
	}
	break
	}
	}

	if len(replacements) > 0 {
	if *confirm {
	fmt.Printf("%sReplacing imports with aliases in file %s\n", logPrefix, pathToFile)
	for key, value := range replacements {
	renameImportUsages(file, key, value)
	}
	ast.SortImports(a.fset, file)
	var buffer bytes.Buffer
	if err = format.Node(&buffer, a.fset, file); err != nil {
	panic(fmt.Sprintf("Error formatting ast node after rewriting import.\n%s\n", err.Error()))
	}

	fileInfo, err := os.Stat(pathToFile)
	if err != nil {
	panic(fmt.Sprintf("Error stat'ing file: %s\n%s\n", pathToFile, err.Error()))
	}

	err = os.WriteFile(pathToFile, buffer.Bytes(), fileInfo.Mode())
	if err != nil {
	panic(fmt.Sprintf("Error writing file: %s\n%s\n", pathToFile, err.Error()))
	}
	}
	}
	}
	}
	}

	func renameImportUsages(f *ast.File, old, new string) {
	// use this to avoid renaming the package declaration, eg:
	// given: package foo; import foo "bar"; foo.Baz, rename foo->qux
	// yield: package foo; import qux "bar"; qux.Baz
	var pkg *ast.Ident

	// Rename top-level old to new, both unresolved names
	// (probably defined in another file) and names that resolve
	// to a declaration we renamed.
	ast.Inspect(f, func(node ast.Node) bool {
	if node == nil {
	return false
	}
	switch id := node.(type) {
	case *ast.File:
	pkg = id.Name
	case *ast.Ident:
	if pkg != nil && id == pkg {
	return false
	}
	if id.Name == old {
	id.Name = new
	}
	}
	return true
	})
	}

	func (a analyzer) filterFiles(fs map[string]ast.File) []*ast.File {
	var files []*ast.File
	for _, f := range fs {
	files = append(files, f)
	}
	return files
	}

	type collector struct {
	dirs []string
	regex *regexp.Regexp
	}

	// handlePath walks the filesystem recursively, collecting directories,
	// ignoring some unneeded directories (hidden/vendored) that are handled
	// specially later.
	func (c *collector) handlePath(path string, info os.FileInfo, err error) error {
	if err != nil {
	return err
	}
	if info.IsDir() {
	// Ignore hidden directories (.git, .cache, etc)
	if len(path) > 1 && path[0] == '.' \|\|
	// OS-specific vendor code tends to be imported by OS-specific
	// packages. We recursively typecheck imported vendored packages for
	// each OS, but don't typecheck everything for every OS.
	path == "vendor" \|\|
	path == "_output" \|\|
	// This is a weird one. /testdata/ is mostly ignored by Go,
	// and this translates to kubernetes/vendor not working.
	// edit/record.go doesn't compile without gopkg.in/yaml.v2
	// in $GOSRC/$GOROOT (both typecheck and the shell script).
	path == "pkg/kubectl/cmd/testdata/edit" {
	return filepath.SkipDir
	}
	if c.regex.MatchString(path) {
	c.dirs = append(c.dirs, path)
	}
	}
	return nil
	}

	func main() {
	flag.Parse()
	args := flag.Args()

	if len(args) == 0 {
	args = append(args, ".")
	}

	regex, err := regexp.Compile(*regex)
	if err != nil {
	log.Fatalf("Error compiling regex: %v", err)
	}
	c := collector{regex: regex}
	for _, arg := range args {
	err := filepath.Walk(arg, c.handlePath)
	if err != nil {
	log.Fatalf("Error walking: %v", err)
	}
	}
	sort.Strings(c.dirs)

	if len(*importAliases) > 0 {
	bytes, err := os.ReadFile(*importAliases)
	if err != nil {
	log.Fatalf("Error reading import aliases: %v", err)
	}
	var stringAliases map[string]string
	err = json.Unmarshal(bytes, &stringAliases)
	if err != nil {
	log.Fatalf("Error loading aliases: %v", err)
	}
	for pattern, name := range stringAliases {
	re, err := regexp.Compile(pattern)
	if err != nil {
	log.Fatalf("Error parsing import path pattern %q as regular expression: %v", pattern, err)
	}
	aliases[re] = name
	}
	}
	if isTerminal {
	logPrefix = "\r" // clear status bar when printing
	}
	fmt.Println("checking-imports: ")

	a := newAnalyzer()
	for _, dir := range c.dirs {
	if isTerminal {
	fmt.Printf("\r\033[0m %-80s", dir)
	}
	a.collect(dir)
	}
	fmt.Println()
	if a.failed {
	os.Exit(1)
	}
	}