// Copyright 2017 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. // The go-contrib-init command helps new Go contributors get their development // environment set up for the Go contribution process. // // It aims to be a complement or alternative to https://golang.org/doc/contribute.html. package main import ( "bytes" "flag" "fmt" "go/build" "io/ioutil" "log" "os" "os/exec" "path/filepath" "regexp" "runtime" "strings" ) var ( 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/*") dry = flag.Bool("dry-run", false, "Fail with problems instead of trying to fix things.") ) func main() { log.SetFlags(0) flag.Parse() checkCLA() checkGoroot() checkWorkingDir() checkGitOrigin() checkGitCodeReview() fmt.Print("All good. Happy hacking!\n" + "Remember to squash your revised commits and preserve the magic Change-Id lines.\n" + "Next steps: https://golang.org/doc/contribute.html#commit_changes\n") } func detectrepo() string { wd, err := os.Getwd() if err != nil { return "go" } for _, path := range filepath.SplitList(build.Default.GOPATH) { rightdir := filepath.Join(path, "src", "golang.org", "x") + string(os.PathSeparator) if strings.HasPrefix(wd, rightdir) { tail := wd[len(rightdir):] end := strings.Index(tail, string(os.PathSeparator)) if end > 0 { repo := tail[:end] return repo } } } return "go" } var googleSourceRx = regexp.MustCompile(`(?m)^(go|go-review)?\.googlesource.com\b`) func checkCLA() { slurp, err := ioutil.ReadFile(cookiesFile()) if err != nil && !os.IsNotExist(err) { log.Fatal(err) } if googleSourceRx.Match(slurp) { // Probably good. return } log.Fatal("Your .gitcookies file isn't configured.\n" + "Next steps:\n" + " * Submit a CLA (https://golang.org/doc/contribute.html#cla) if not done\n" + " * Go to https://go.googlesource.com/ and click \"Generate Password\" at the top,\n" + " then follow instructions.\n" + " * Run go-contrib-init again.\n") } func expandUser(s string) string { env := "HOME" if runtime.GOOS == "windows" { env = "USERPROFILE" } else if runtime.GOOS == "plan9" { env = "home" } home := os.Getenv(env) if home == "" { return s } if len(s) >= 2 && s[0] == '~' && os.IsPathSeparator(s[1]) { if runtime.GOOS == "windows" { s = filepath.ToSlash(filepath.Join(home, s[2:])) } else { s = filepath.Join(home, s[2:]) } } return os.Expand(s, func(env string) string { if env == "HOME" { return home } return os.Getenv(env) }) } func cookiesFile() string { out, _ := exec.Command("git", "config", "http.cookiefile").Output() if s := strings.TrimSpace(string(out)); s != "" { if strings.HasPrefix(s, "~") { s = expandUser(s) } return s } if runtime.GOOS == "windows" { return filepath.Join(os.Getenv("USERPROFILE"), ".gitcookies") } return filepath.Join(os.Getenv("HOME"), ".gitcookies") } func checkGoroot() { v := os.Getenv("GOROOT") if v == "" { return } if *repo == "go" { if strings.HasPrefix(v, "/usr/") { log.Fatalf("Your GOROOT environment variable is set to %q\n"+ "This is almost certainly not what you want. Either unset\n"+ "your GOROOT or set it to the path of your development version\n"+ "of Go.", v) } slurp, err := ioutil.ReadFile(filepath.Join(v, "VERSION")) if err == nil { slurp = bytes.TrimSpace(slurp) log.Fatalf("Your GOROOT environment variable is set to %q\n"+ "But that path is to a binary release of Go, with VERSION file %q.\n"+ "You should hack on Go in a fresh checkout of Go. Fix or unset your GOROOT.\n", v, slurp) } } } func checkWorkingDir() { wd, err := os.Getwd() if err != nil { log.Fatal(err) } if *repo == "go" { if inGoPath(wd) { log.Fatalf(`You can't work on Go from within your GOPATH. Please checkout Go outside of your GOPATH Current directory: %s GOPATH: %s `, wd, os.Getenv("GOPATH")) } return } gopath := firstGoPath() if gopath == "" { log.Fatal("Your GOPATH is not set, please set it") } rightdir := filepath.Join(gopath, "src", "golang.org", "x", *repo) if !strings.HasPrefix(wd, rightdir) { dirExists, err := exists(rightdir) if err != nil { log.Fatal(err) } if !dirExists { log.Fatalf("The repo you want to work on is currently not on your system.\n"+ "Run %q to obtain this repo\n"+ "then go to the directory %q\n", "go get -d golang.org/x/"+*repo, rightdir) } log.Fatalf("Your current directory is:%q\n"+ "Working on golang/x/%v requires you be in %q\n", wd, *repo, rightdir) } } func firstGoPath() string { list := filepath.SplitList(build.Default.GOPATH) if len(list) < 1 { return "" } return list[0] } func exists(path string) (bool, error) { _, err := os.Stat(path) if os.IsNotExist(err) { return false, nil } return true, err } func inGoPath(wd string) bool { if os.Getenv("GOPATH") == "" { return false } for _, path := range filepath.SplitList(os.Getenv("GOPATH")) { if strings.HasPrefix(wd, filepath.Join(path, "src")) { return true } } return false } // mostly check that they didn't clone from github func checkGitOrigin() { if _, err := exec.LookPath("git"); err != nil { log.Fatalf("You don't appear to have git installed. Do that.") } wantRemote := "https://go.googlesource.com/" + *repo remotes, err := exec.Command("git", "remote", "-v").Output() if err != nil { msg := cmdErr(err) if strings.Contains(msg, "Not a git repository") { log.Fatalf("Your current directory is not in a git checkout of %s", wantRemote) } log.Fatalf("Error running git remote -v: %v", msg) } matches := 0 for _, line := range strings.Split(string(remotes), "\n") { line = strings.TrimSpace(line) if !strings.HasPrefix(line, "origin") { continue } if !strings.Contains(line, wantRemote) { curRemote := strings.Fields(strings.TrimPrefix(line, "origin"))[0] // TODO: if not in dryRun mode, just fix it? log.Fatalf("Current directory's git was cloned from %q; origin should be %q", curRemote, wantRemote) } matches++ } if matches == 0 { log.Fatalf("git remote -v output didn't contain expected %q. Got:\n%s", wantRemote, remotes) } } func cmdErr(err error) string { if ee, ok := err.(*exec.ExitError); ok && len(ee.Stderr) > 0 { return fmt.Sprintf("%s: %s", err, ee.Stderr) } return fmt.Sprint(err) } func checkGitCodeReview() { if _, err := exec.LookPath("git-codereview"); err != nil { if *dry { log.Fatalf("You don't appear to have git-codereview tool. While this is technically optional,\n" + "almost all Go contributors use it. Our documentation and this tool assume it is used.\n" + "To install it, run:\n\n\t$ go get golang.org/x/review/git-codereview\n\n(Then run go-contrib-init again)") } err := exec.Command("go", "get", "golang.org/x/review/git-codereview").Run() if err != nil { log.Fatalf("Error running go get golang.org/x/review/git-codereview: %v", cmdErr(err)) } log.Printf("Installed git-codereview (ran `go get golang.org/x/review/git-codereview`)") } missing := false for _, cmd := range []string{"change", "gofmt", "mail", "pending", "submit", "sync"} { v, _ := exec.Command("git", "config", "alias."+cmd).Output() if strings.Contains(string(v), "codereview") { continue } if *dry { log.Printf("Missing alias. Run:\n\t$ git config alias.%s \"codereview %s\"", cmd, cmd) missing = true } else { err := exec.Command("git", "config", "alias."+cmd, "codereview "+cmd).Run() if err != nil { log.Fatalf("Error setting alias.%s: %v", cmd, cmdErr(err)) } } } if missing { log.Fatalf("Missing aliases. (While optional, this tool assumes you use them.)") } }