github.com/april1989/origin-go-tools@v0.0.32/cmd/go-contrib-init/contrib.go (about)

     1  // Copyright 2017 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // The go-contrib-init command helps new Go contributors get their development
     6  // environment set up for the Go contribution process.
     7  //
     8  // It aims to be a complement or alternative to https://golang.org/doc/contribute.html.
     9  package main
    10  
    11  import (
    12  	"bytes"
    13  	"flag"
    14  	"fmt"
    15  	"go/build"
    16  	"io/ioutil"
    17  	"log"
    18  	"os"
    19  	"os/exec"
    20  	"path/filepath"
    21  	"regexp"
    22  	"runtime"
    23  	"strings"
    24  )
    25  
    26  var (
    27  	repo = flag.String("repo", detectrepo(), "Which go repo you want to contribute to. Use \"go\" for the core, or e.g. \"net\" for golang.org/x/net/*")
    28  	dry  = flag.Bool("dry-run", false, "Fail with problems instead of trying to fix things.")
    29  )
    30  
    31  func main() {
    32  	log.SetFlags(0)
    33  	flag.Parse()
    34  
    35  	checkCLA()
    36  	checkGoroot()
    37  	checkWorkingDir()
    38  	checkGitOrigin()
    39  	checkGitCodeReview()
    40  	fmt.Print("All good. Happy hacking!\n" +
    41  		"Remember to squash your revised commits and preserve the magic Change-Id lines.\n" +
    42  		"Next steps: https://golang.org/doc/contribute.html#commit_changes\n")
    43  }
    44  
    45  func detectrepo() string {
    46  	wd, err := os.Getwd()
    47  	if err != nil {
    48  		return "go"
    49  	}
    50  
    51  	for _, path := range filepath.SplitList(build.Default.GOPATH) {
    52  		rightdir := filepath.Join(path, "src", "golang.org", "x") + string(os.PathSeparator)
    53  		if strings.HasPrefix(wd, rightdir) {
    54  			tail := wd[len(rightdir):]
    55  			end := strings.Index(tail, string(os.PathSeparator))
    56  			if end > 0 {
    57  				repo := tail[:end]
    58  				return repo
    59  			}
    60  		}
    61  	}
    62  
    63  	return "go"
    64  }
    65  
    66  var googleSourceRx = regexp.MustCompile(`(?m)^(go|go-review)?\.googlesource.com\b`)
    67  
    68  func checkCLA() {
    69  	slurp, err := ioutil.ReadFile(cookiesFile())
    70  	if err != nil && !os.IsNotExist(err) {
    71  		log.Fatal(err)
    72  	}
    73  	if googleSourceRx.Match(slurp) {
    74  		// Probably good.
    75  		return
    76  	}
    77  	log.Fatal("Your .gitcookies file isn't configured.\n" +
    78  		"Next steps:\n" +
    79  		"  * Submit a CLA (https://golang.org/doc/contribute.html#cla) if not done\n" +
    80  		"  * Go to https://go.googlesource.com/ and click \"Generate Password\" at the top,\n" +
    81  		"    then follow instructions.\n" +
    82  		"  * Run go-contrib-init again.\n")
    83  }
    84  
    85  func expandUser(s string) string {
    86  	env := "HOME"
    87  	if runtime.GOOS == "windows" {
    88  		env = "USERPROFILE"
    89  	} else if runtime.GOOS == "plan9" {
    90  		env = "home"
    91  	}
    92  	home := os.Getenv(env)
    93  	if home == "" {
    94  		return s
    95  	}
    96  
    97  	if len(s) >= 2 && s[0] == '~' && os.IsPathSeparator(s[1]) {
    98  		if runtime.GOOS == "windows" {
    99  			s = filepath.ToSlash(filepath.Join(home, s[2:]))
   100  		} else {
   101  			s = filepath.Join(home, s[2:])
   102  		}
   103  	}
   104  	return os.Expand(s, func(env string) string {
   105  		if env == "HOME" {
   106  			return home
   107  		}
   108  		return os.Getenv(env)
   109  	})
   110  }
   111  
   112  func cookiesFile() string {
   113  	out, _ := exec.Command("git", "config", "http.cookiefile").Output()
   114  	if s := strings.TrimSpace(string(out)); s != "" {
   115  		if strings.HasPrefix(s, "~") {
   116  			s = expandUser(s)
   117  		}
   118  		return s
   119  	}
   120  	if runtime.GOOS == "windows" {
   121  		return filepath.Join(os.Getenv("USERPROFILE"), ".gitcookies")
   122  	}
   123  	return filepath.Join(os.Getenv("HOME"), ".gitcookies")
   124  }
   125  
   126  func checkGoroot() {
   127  	v := os.Getenv("GOROOT")
   128  	if v == "" {
   129  		return
   130  	}
   131  	if *repo == "go" {
   132  		if strings.HasPrefix(v, "/usr/") {
   133  			log.Fatalf("Your GOROOT environment variable is set to %q\n"+
   134  				"This is almost certainly not what you want. Either unset\n"+
   135  				"your GOROOT or set it to the path of your development version\n"+
   136  				"of Go.", v)
   137  		}
   138  		slurp, err := ioutil.ReadFile(filepath.Join(v, "VERSION"))
   139  		if err == nil {
   140  			slurp = bytes.TrimSpace(slurp)
   141  			log.Fatalf("Your GOROOT environment variable is set to %q\n"+
   142  				"But that path is to a binary release of Go, with VERSION file %q.\n"+
   143  				"You should hack on Go in a fresh checkout of Go. Fix or unset your GOROOT.\n",
   144  				v, slurp)
   145  		}
   146  	}
   147  }
   148  
   149  func checkWorkingDir() {
   150  	wd, err := os.Getwd()
   151  	if err != nil {
   152  		log.Fatal(err)
   153  	}
   154  	if *repo == "go" {
   155  		if inGoPath(wd) {
   156  			log.Fatalf(`You can't work on Go from within your GOPATH. Please checkout Go outside of your GOPATH
   157  
   158  Current directory: %s
   159  GOPATH: %s
   160  `, wd, os.Getenv("GOPATH"))
   161  		}
   162  		return
   163  	}
   164  
   165  	gopath := firstGoPath()
   166  	if gopath == "" {
   167  		log.Fatal("Your GOPATH is not set, please set it")
   168  	}
   169  
   170  	rightdir := filepath.Join(gopath, "src", "golang.org", "x", *repo)
   171  	if !strings.HasPrefix(wd, rightdir) {
   172  		dirExists, err := exists(rightdir)
   173  		if err != nil {
   174  			log.Fatal(err)
   175  		}
   176  		if !dirExists {
   177  			log.Fatalf("The repo you want to work on is currently not on your system.\n"+
   178  				"Run %q to obtain this repo\n"+
   179  				"then go to the directory %q\n",
   180  				"go get -d golang.org/x/"+*repo, rightdir)
   181  		}
   182  		log.Fatalf("Your current directory is:%q\n"+
   183  			"Working on golang/x/%v requires you be in %q\n",
   184  			wd, *repo, rightdir)
   185  	}
   186  }
   187  
   188  func firstGoPath() string {
   189  	list := filepath.SplitList(build.Default.GOPATH)
   190  	if len(list) < 1 {
   191  		return ""
   192  	}
   193  	return list[0]
   194  }
   195  
   196  func exists(path string) (bool, error) {
   197  	_, err := os.Stat(path)
   198  	if os.IsNotExist(err) {
   199  		return false, nil
   200  	}
   201  	return true, err
   202  }
   203  
   204  func inGoPath(wd string) bool {
   205  	if os.Getenv("GOPATH") == "" {
   206  		return false
   207  	}
   208  
   209  	for _, path := range filepath.SplitList(os.Getenv("GOPATH")) {
   210  		if strings.HasPrefix(wd, filepath.Join(path, "src")) {
   211  			return true
   212  		}
   213  	}
   214  
   215  	return false
   216  }
   217  
   218  // mostly check that they didn't clone from github
   219  func checkGitOrigin() {
   220  	if _, err := exec.LookPath("git"); err != nil {
   221  		log.Fatalf("You don't appear to have git installed. Do that.")
   222  	}
   223  	wantRemote := "https://go.googlesource.com/" + *repo
   224  	remotes, err := exec.Command("git", "remote", "-v").Output()
   225  	if err != nil {
   226  		msg := cmdErr(err)
   227  		if strings.Contains(msg, "Not a git repository") {
   228  			log.Fatalf("Your current directory is not in a git checkout of %s", wantRemote)
   229  		}
   230  		log.Fatalf("Error running git remote -v: %v", msg)
   231  	}
   232  	matches := 0
   233  	for _, line := range strings.Split(string(remotes), "\n") {
   234  		line = strings.TrimSpace(line)
   235  		if !strings.HasPrefix(line, "origin") {
   236  			continue
   237  		}
   238  		if !strings.Contains(line, wantRemote) {
   239  			curRemote := strings.Fields(strings.TrimPrefix(line, "origin"))[0]
   240  			// TODO: if not in dryRun mode, just fix it?
   241  			log.Fatalf("Current directory's git was cloned from %q; origin should be %q", curRemote, wantRemote)
   242  		}
   243  		matches++
   244  	}
   245  	if matches == 0 {
   246  		log.Fatalf("git remote -v output didn't contain expected %q. Got:\n%s", wantRemote, remotes)
   247  	}
   248  }
   249  
   250  func cmdErr(err error) string {
   251  	if ee, ok := err.(*exec.ExitError); ok && len(ee.Stderr) > 0 {
   252  		return fmt.Sprintf("%s: %s", err, ee.Stderr)
   253  	}
   254  	return fmt.Sprint(err)
   255  }
   256  
   257  func checkGitCodeReview() {
   258  	if _, err := exec.LookPath("git-codereview"); err != nil {
   259  		if *dry {
   260  			log.Fatalf("You don't appear to have git-codereview tool. While this is technically optional,\n" +
   261  				"almost all Go contributors use it. Our documentation and this tool assume it is used.\n" +
   262  				"To install it, run:\n\n\t$ go get golang.org/x/review/git-codereview\n\n(Then run go-contrib-init again)")
   263  		}
   264  		err := exec.Command("go", "get", "golang.org/x/review/git-codereview").Run()
   265  		if err != nil {
   266  			log.Fatalf("Error running go get golang.org/x/review/git-codereview: %v", cmdErr(err))
   267  		}
   268  		log.Printf("Installed git-codereview (ran `go get golang.org/x/review/git-codereview`)")
   269  	}
   270  	missing := false
   271  	for _, cmd := range []string{"change", "gofmt", "mail", "pending", "submit", "sync"} {
   272  		v, _ := exec.Command("git", "config", "alias."+cmd).Output()
   273  		if strings.Contains(string(v), "codereview") {
   274  			continue
   275  		}
   276  		if *dry {
   277  			log.Printf("Missing alias. Run:\n\t$ git config alias.%s \"codereview %s\"", cmd, cmd)
   278  			missing = true
   279  		} else {
   280  			err := exec.Command("git", "config", "alias."+cmd, "codereview "+cmd).Run()
   281  			if err != nil {
   282  				log.Fatalf("Error setting alias.%s: %v", cmd, cmdErr(err))
   283  			}
   284  		}
   285  	}
   286  	if missing {
   287  		log.Fatalf("Missing aliases. (While optional, this tool assumes you use them.)")
   288  	}
   289  }