// Copyright 2017 Google Inc. All rights reserved. // // 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. // Microfactory is a tool to incrementally compile a go program. It's similar // to `go install`, but doesn't require a GOPATH. A package->path mapping can // be specified as command line options: // // -pkg-path android/soong=build/soong // -pkg-path github.com/google/blueprint=build/blueprint // // The paths can be relative to the current working directory, or an absolute // path. Both packages and paths are compared with full directory names, so the // android/soong-test package wouldn't be mapped in the above case. // // Microfactory will ignore *_test.go files, and limits *_darwin.go and // *_linux.go files to MacOS and Linux respectively. It does not support build // tags or any other suffixes. // // Builds are incremental by package. All input files are hashed, and if the // hash of an input or dependency changes, the package is rebuilt. // // It also exposes the -trimpath option from go's compiler so that embedded // path names (such as in log.Llongfile) are relative paths instead of absolute // paths. // // If you don't have a previously built version of Microfactory, when used with // -b <microfactory_bin_file>, Microfactory can rebuild itself as necessary. // Combined with a shell script like microfactory.bash that uses `go run` to // run Microfactory for the first time, go programs can be quickly bootstrapped // entirely from source (and a standard go distribution). package microfactory import ( "bytes" "crypto/sha1" "flag" "fmt" "go/ast" "go/build" "go/parser" "go/token" "io" "io/ioutil" "os" "os/exec" "path/filepath" "runtime" "sort" "strconv" "strings" "sync" "syscall" "time" ) var ( goToolDir = filepath.Join(runtime.GOROOT(), "pkg", "tool", runtime.GOOS+"_"+runtime.GOARCH) goVersion = findGoVersion() isGo18 = strings.Contains(goVersion, "go1.8") ) func findGoVersion() string { if version, err := ioutil.ReadFile(filepath.Join(runtime.GOROOT(), "VERSION")); err == nil { return string(version) } cmd := exec.Command(filepath.Join(runtime.GOROOT(), "bin", "go"), "version") if version, err := cmd.Output(); err == nil { return string(version) } else { panic(fmt.Sprintf("Unable to discover go version: %v", err)) } } type Config struct { Race bool Verbose bool TrimPath string TraceFunc func(name string) func() pkgs []string paths map[string]string } func (c *Config) Map(pkgPrefix, pathPrefix string) error { if c.paths == nil { c.paths = make(map[string]string) } if _, ok := c.paths[pkgPrefix]; ok { return fmt.Errorf("Duplicate package prefix: %q", pkgPrefix) } c.pkgs = append(c.pkgs, pkgPrefix) c.paths[pkgPrefix] = pathPrefix return nil } // Path takes a package name, applies the path mappings and returns the resulting path. // // If the package isn't mapped, we'll return false to prevent compilation attempts. func (c *Config) Path(pkg string) (string, bool, error) { if c == nil || c.paths == nil { return "", false, fmt.Errorf("No package mappings") } for _, pkgPrefix := range c.pkgs { if pkg == pkgPrefix { return c.paths[pkgPrefix], true, nil } else if strings.HasPrefix(pkg, pkgPrefix+"/") { return filepath.Join(c.paths[pkgPrefix], strings.TrimPrefix(pkg, pkgPrefix+"/")), true, nil } } return "", false, nil } func (c *Config) trace(format string, a ...interface{}) func() { if c.TraceFunc == nil { return func() {} } s := strings.TrimSpace(fmt.Sprintf(format, a...)) return c.TraceFunc(s) } func un(f func()) { f() } type GoPackage struct { Name string // Inputs directDeps []*GoPackage // specified directly by the module allDeps []*GoPackage // direct dependencies and transitive dependencies files []string // Outputs pkgDir string output string hashResult []byte // Status mutex sync.Mutex compiled bool failed error rebuilt bool } // LinkedHashMap<string, GoPackage> type linkedDepSet struct { packageSet map[string](*GoPackage) packageList []*GoPackage } func newDepSet() *linkedDepSet { return &linkedDepSet{packageSet: make(map[string]*GoPackage)} } func (s *linkedDepSet) tryGetByName(name string) (*GoPackage, bool) { pkg, contained := s.packageSet[name] return pkg, contained } func (s *linkedDepSet) getByName(name string) *GoPackage { pkg, _ := s.tryGetByName(name) return pkg } func (s *linkedDepSet) add(name string, goPackage *GoPackage) { s.packageSet[name] = goPackage s.packageList = append(s.packageList, goPackage) } func (s *linkedDepSet) ignore(name string) { s.packageSet[name] = nil } // FindDeps searches all applicable go files in `path`, parses all of them // for import dependencies that exist in pkgMap, then recursively does the // same for all of those dependencies. func (p *GoPackage) FindDeps(config *Config, path string) error { defer un(config.trace("findDeps")) depSet := newDepSet() err := p.findDeps(config, path, depSet) if err != nil { return err } p.allDeps = depSet.packageList return nil } // Roughly equivalent to go/build.Context.match func matchBuildTag(name string) bool { if name == "" { return false } if i := strings.Index(name, ","); i >= 0 { ok1 := matchBuildTag(name[:i]) ok2 := matchBuildTag(name[i+1:]) return ok1 && ok2 } if strings.HasPrefix(name, "!!") { return false } if strings.HasPrefix(name, "!") { return len(name) > 1 && !matchBuildTag(name[1:]) } if name == runtime.GOOS || name == runtime.GOARCH || name == "gc" { return true } for _, tag := range build.Default.BuildTags { if tag == name { return true } } for _, tag := range build.Default.ReleaseTags { if tag == name { return true } } return false } func parseBuildComment(comment string) (matches, ok bool) { if !strings.HasPrefix(comment, "//") { return false, false } for i, c := range comment { if i < 2 || c == ' ' || c == '\t' { continue } else if c == '+' { f := strings.Fields(comment[i:]) if f[0] == "+build" { matches = false for _, tok := range f[1:] { matches = matches || matchBuildTag(tok) } return matches, true } } break } return false, false } // findDeps is the recursive version of FindDeps. allPackages is the map of // all locally defined packages so that the same dependency of two different // packages is only resolved once. func (p *GoPackage) findDeps(config *Config, path string, allPackages *linkedDepSet) error { // If this ever becomes too slow, we can look at reading the files once instead of twice // But that just complicates things today, and we're already really fast. foundPkgs, err := parser.ParseDir(token.NewFileSet(), path, func(fi os.FileInfo) bool { name := fi.Name() if fi.IsDir() || strings.HasSuffix(name, "_test.go") || name[0] == '.' || name[0] == '_' { return false } if runtime.GOOS != "darwin" && strings.HasSuffix(name, "_darwin.go") { return false } if runtime.GOOS != "linux" && strings.HasSuffix(name, "_linux.go") { return false } return true }, parser.ImportsOnly|parser.ParseComments) if err != nil { return fmt.Errorf("Error parsing directory %q: %v", path, err) } var foundPkg *ast.Package // foundPkgs is a map[string]*ast.Package, but we only want one package if len(foundPkgs) != 1 { return fmt.Errorf("Expected one package in %q, got %d", path, len(foundPkgs)) } // Extract the first (and only) entry from the map. for _, pkg := range foundPkgs { foundPkg = pkg } var deps []string localDeps := make(map[string]bool) for filename, astFile := range foundPkg.Files { ignore := false for _, commentGroup := range astFile.Comments { for _, comment := range commentGroup.List { if matches, ok := parseBuildComment(comment.Text); ok && !matches { ignore = true } } } if ignore { continue } p.files = append(p.files, filename) for _, importSpec := range astFile.Imports { name, err := strconv.Unquote(importSpec.Path.Value) if err != nil { return fmt.Errorf("%s: invalid quoted string: <%s> %v", filename, importSpec.Path.Value, err) } if pkg, ok := allPackages.tryGetByName(name); ok { if pkg != nil { if _, ok := localDeps[name]; !ok { deps = append(deps, name) localDeps[name] = true } } continue } var pkgPath string if path, ok, err := config.Path(name); err != nil { return err } else if !ok { // Probably in the stdlib, but if not, then the compiler will fail with a reasonable error message // Mark it as such so that we don't try to decode its path again. allPackages.ignore(name) continue } else { pkgPath = path } pkg := &GoPackage{ Name: name, } deps = append(deps, name) allPackages.add(name, pkg) localDeps[name] = true if err := pkg.findDeps(config, pkgPath, allPackages); err != nil { return err } } } sort.Strings(p.files) if config.Verbose { fmt.Fprintf(os.Stderr, "Package %q depends on %v\n", p.Name, deps) } sort.Strings(deps) for _, dep := range deps { p.directDeps = append(p.directDeps, allPackages.getByName(dep)) } return nil } func (p *GoPackage) Compile(config *Config, outDir string) error { p.mutex.Lock() defer p.mutex.Unlock() if p.compiled { return p.failed } p.compiled = true // Build all dependencies in parallel, then fail if any of them failed. var wg sync.WaitGroup for _, dep := range p.directDeps { wg.Add(1) go func(dep *GoPackage) { defer wg.Done() dep.Compile(config, outDir) }(dep) } wg.Wait() for _, dep := range p.directDeps { if dep.failed != nil { p.failed = dep.failed return p.failed } } endTrace := config.trace("check compile %s", p.Name) p.pkgDir = filepath.Join(outDir, strings.Replace(p.Name, "/", "-", -1)) p.output = filepath.Join(p.pkgDir, p.Name) + ".a" shaFile := p.output + ".hash" hash := sha1.New() fmt.Fprintln(hash, runtime.GOOS, runtime.GOARCH, goVersion) cmd := exec.Command(filepath.Join(goToolDir, "compile"), "-o", p.output, "-p", p.Name, "-complete", "-pack", "-nolocalimports") if !isGo18 { cmd.Args = append(cmd.Args, "-c", fmt.Sprintf("%d", runtime.NumCPU())) } if config.Race { cmd.Args = append(cmd.Args, "-race") fmt.Fprintln(hash, "-race") } if config.TrimPath != "" { cmd.Args = append(cmd.Args, "-trimpath", config.TrimPath) fmt.Fprintln(hash, config.TrimPath) } for _, dep := range p.directDeps { cmd.Args = append(cmd.Args, "-I", dep.pkgDir) hash.Write(dep.hashResult) } for _, filename := range p.files { cmd.Args = append(cmd.Args, filename) fmt.Fprintln(hash, filename) // Hash the contents of the input files f, err := os.Open(filename) if err != nil { f.Close() err = fmt.Errorf("%s: %v", filename, err) p.failed = err return err } _, err = io.Copy(hash, f) if err != nil { f.Close() err = fmt.Errorf("%s: %v", filename, err) p.failed = err return err } f.Close() } p.hashResult = hash.Sum(nil) var rebuild bool if _, err := os.Stat(p.output); err != nil { rebuild = true } if !rebuild { if oldSha, err := ioutil.ReadFile(shaFile); err == nil { rebuild = !bytes.Equal(oldSha, p.hashResult) } else { rebuild = true } } endTrace() if !rebuild { return nil } defer un(config.trace("compile %s", p.Name)) err := os.RemoveAll(p.pkgDir) if err != nil { err = fmt.Errorf("%s: %v", p.Name, err) p.failed = err return err } err = os.MkdirAll(filepath.Dir(p.output), 0777) if err != nil { err = fmt.Errorf("%s: %v", p.Name, err) p.failed = err return err } cmd.Stdin = nil cmd.Stdout = os.Stdout cmd.Stderr = os.Stderr if config.Verbose { fmt.Fprintln(os.Stderr, cmd.Args) } err = cmd.Run() if err != nil { commandText := strings.Join(cmd.Args, " ") err = fmt.Errorf("%q: %v", commandText, err) p.failed = err return err } err = ioutil.WriteFile(shaFile, p.hashResult, 0666) if err != nil { err = fmt.Errorf("%s: %v", p.Name, err) p.failed = err return err } p.rebuilt = true return nil } func (p *GoPackage) Link(config *Config, out string) error { if p.Name != "main" { return fmt.Errorf("Can only link main package") } endTrace := config.trace("check link %s", p.Name) shaFile := filepath.Join(filepath.Dir(out), "."+filepath.Base(out)+"_hash") if !p.rebuilt { if _, err := os.Stat(out); err != nil { p.rebuilt = true } else if oldSha, err := ioutil.ReadFile(shaFile); err != nil { p.rebuilt = true } else { p.rebuilt = !bytes.Equal(oldSha, p.hashResult) } } endTrace() if !p.rebuilt { return nil } defer un(config.trace("link %s", p.Name)) err := os.Remove(shaFile) if err != nil && !os.IsNotExist(err) { return err } err = os.Remove(out) if err != nil && !os.IsNotExist(err) { return err } cmd := exec.Command(filepath.Join(goToolDir, "link"), "-o", out) if config.Race { cmd.Args = append(cmd.Args, "-race") } for _, dep := range p.allDeps { cmd.Args = append(cmd.Args, "-L", dep.pkgDir) } cmd.Args = append(cmd.Args, p.output) cmd.Stdin = nil cmd.Stdout = os.Stdout cmd.Stderr = os.Stderr if config.Verbose { fmt.Fprintln(os.Stderr, cmd.Args) } err = cmd.Run() if err != nil { return fmt.Errorf("command %s failed with error %v", cmd.Args, err) } return ioutil.WriteFile(shaFile, p.hashResult, 0666) } func Build(config *Config, out, pkg string) (*GoPackage, error) { p := &GoPackage{ Name: "main", } lockFileName := filepath.Join(filepath.Dir(out), "."+filepath.Base(out)+".lock") lockFile, err := os.OpenFile(lockFileName, os.O_RDWR|os.O_CREATE, 0666) if err != nil { return nil, fmt.Errorf("Error creating lock file (%q): %v", lockFileName, err) } defer lockFile.Close() err = syscall.Flock(int(lockFile.Fd()), syscall.LOCK_EX) if err != nil { return nil, fmt.Errorf("Error locking file (%q): %v", lockFileName, err) } path, ok, err := config.Path(pkg) if err != nil { return nil, fmt.Errorf("Error finding package %q for main: %v", pkg, err) } if !ok { return nil, fmt.Errorf("Could not find package %q", pkg) } intermediates := filepath.Join(filepath.Dir(out), "."+filepath.Base(out)+"_intermediates") if err := os.MkdirAll(intermediates, 0777); err != nil { return nil, fmt.Errorf("Failed to create intermediates directory: %v", err) } if err := p.FindDeps(config, path); err != nil { return nil, fmt.Errorf("Failed to find deps of %v: %v", pkg, err) } if err := p.Compile(config, intermediates); err != nil { return nil, fmt.Errorf("Failed to compile %v: %v", pkg, err) } if err := p.Link(config, out); err != nil { return nil, fmt.Errorf("Failed to link %v: %v", pkg, err) } return p, nil } // rebuildMicrofactory checks to see if microfactory itself needs to be rebuilt, // and if does, it will launch a new copy and return true. Otherwise it will return // false to continue executing. func rebuildMicrofactory(config *Config, mybin string) bool { if pkg, err := Build(config, mybin, "github.com/google/blueprint/microfactory/main"); err != nil { fmt.Fprintln(os.Stderr, err) os.Exit(1) } else if !pkg.rebuilt { return false } cmd := exec.Command(mybin, os.Args[1:]...) cmd.Stdin = os.Stdin cmd.Stdout = os.Stdout cmd.Stderr = os.Stderr if err := cmd.Run(); err == nil { return true } else if e, ok := err.(*exec.ExitError); ok { os.Exit(e.ProcessState.Sys().(syscall.WaitStatus).ExitStatus()) } os.Exit(1) return true } // microfactory.bash will make a copy of this file renamed into the main package for use with `go run` func main() { Main() } func Main() { var output, mybin string var config Config pkgMap := pkgPathMappingVar{&config} flags := flag.NewFlagSet("", flag.ExitOnError) flags.BoolVar(&config.Race, "race", false, "enable data race detection.") flags.BoolVar(&config.Verbose, "v", false, "Verbose") flags.StringVar(&output, "o", "", "Output file") flags.StringVar(&mybin, "b", "", "Microfactory binary location") flags.StringVar(&config.TrimPath, "trimpath", "", "remove prefix from recorded source file paths") flags.Var(&pkgMap, "pkg-path", "Mapping of package prefixes to file paths") err := flags.Parse(os.Args[1:]) if err == flag.ErrHelp || flags.NArg() != 1 || output == "" { fmt.Fprintln(os.Stderr, "Usage:", os.Args[0], "-o out/binary <main-package>") flags.PrintDefaults() os.Exit(1) } tracePath := filepath.Join(filepath.Dir(output), "."+filepath.Base(output)+".trace") if traceFile, err := os.OpenFile(tracePath, os.O_RDWR|os.O_CREATE|os.O_APPEND, 0666); err == nil { defer traceFile.Close() config.TraceFunc = func(name string) func() { fmt.Fprintf(traceFile, "%d B %s\n", time.Now().UnixNano()/1000, name) return func() { fmt.Fprintf(traceFile, "%d E %s\n", time.Now().UnixNano()/1000, name) } } } if executable, err := os.Executable(); err == nil { defer un(config.trace("microfactory %s", executable)) } else { defer un(config.trace("microfactory <unknown>")) } if mybin != "" { if rebuildMicrofactory(&config, mybin) { return } } if _, err := Build(&config, output, flags.Arg(0)); err != nil { fmt.Fprintln(os.Stderr, err) os.Exit(1) } } // pkgPathMapping can be used with flag.Var to parse -pkg-path arguments of // <package-prefix>=<path-prefix> mappings. type pkgPathMappingVar struct{ *Config } func (pkgPathMappingVar) String() string { return "<package-prefix>=<path-prefix>" } func (p *pkgPathMappingVar) Set(value string) error { equalPos := strings.Index(value, "=") if equalPos == -1 { return fmt.Errorf("Argument must be in the form of: %q", p.String()) } pkgPrefix := strings.TrimSuffix(value[:equalPos], "/") pathPrefix := strings.TrimSuffix(value[equalPos+1:], "/") return p.Map(pkgPrefix, pathPrefix) }