// Copyright 2019 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. // +build ignore package main import ( "archive/tar" "bytes" "compress/gzip" "flag" "fmt" "io" "io/ioutil" "net/http" "os" "os/exec" "path" "path/filepath" "regexp" "runtime" "strings" "testing" "time" ) var ( regenerate = flag.Bool("regenerate", false, "regenerate files") protobufVersion = "3.7.1" golangVersions = []string{"1.9.7", "1.10.8", "1.11.6", "1.12.1"} golangLatest = golangVersions[len(golangVersions)-1] // purgeTimeout determines the maximum age of unused sub-directories. purgeTimeout = 30 * 24 * time.Hour // 1 month // Variables initialized by mustInitDeps. goPath string modulePath string protobufPath string ) func Test(t *testing.T) { mustInitDeps(t) if *regenerate { t.Run("Generate", func(t *testing.T) { fmt.Print(mustRunCommand(t, ".", "go", "run", "./internal/cmd/generate-types", "-execute")) fmt.Print(mustRunCommand(t, ".", "go", "run", "./internal/cmd/generate-protos", "-execute")) files := strings.Split(strings.TrimSpace(mustRunCommand(t, ".", "git", "ls-files", "*.go")), "\n") mustRunCommand(t, ".", append([]string{"gofmt", "-w"}, files...)...) }) t.SkipNow() } for _, v := range golangVersions { t.Run("Go"+v, func(t *testing.T) { runGo := func(label, workDir string, args ...string) { args[0] += v t.Run(label, func(t *testing.T) { t.Parallel() mustRunCommand(t, workDir, args...) }) } workDir := filepath.Join(goPath, "src", modulePath) runGo("TestNormal", workDir, "go", "test", "-race", "./...") runGo("TestPureGo", workDir, "go", "test", "-race", "-tags", "purego", "./...") runGo("TestReflect", workDir, "go", "test", "-race", "-tags", "protoreflect", "./...") if v == golangLatest { runGo("TestProto1Legacy", workDir, "go", "test", "-race", "-tags", "proto1_legacy", "./...") runGo("TestProtocGenGo", "cmd/protoc-gen-go/testdata", "go", "test") runGo("TestProtocGenGoGRPC", "cmd/protoc-gen-go-grpc/testdata", "go", "test") } }) } t.Run("ConformanceTests", func(t *testing.T) { driverPath := filepath.Join("internal", "cmd", "conformance") driver := filepath.Join(driverPath, "conformance.sh") failureList := filepath.Join(driverPath, "failure_list_go.txt") runner := filepath.Join(protobufPath, "conformance", "conformance-test-runner") mustRunCommand(t, ".", runner, "--failure_list", failureList, "--enforce_recommended", driver) }) t.Run("GeneratedGoFiles", func(t *testing.T) { diff := mustRunCommand(t, ".", "go", "run", "./internal/cmd/generate-types") if strings.TrimSpace(diff) != "" { t.Fatalf("stale generated files:\n%v", diff) } diff = mustRunCommand(t, ".", "go", "run", "./internal/cmd/generate-protos") if strings.TrimSpace(diff) != "" { t.Fatalf("stale generated files:\n%v", diff) } }) t.Run("FormattedGoFiles", func(t *testing.T) { files := strings.Split(strings.TrimSpace(mustRunCommand(t, ".", "git", "ls-files", "*.go")), "\n") diff := mustRunCommand(t, ".", append([]string{"gofmt", "-d"}, files...)...) if strings.TrimSpace(diff) != "" { t.Fatalf("unformatted source files:\n%v", diff) } }) t.Run("CommittedGitChanges", func(t *testing.T) { diff := mustRunCommand(t, ".", "git", "diff", "--no-prefix", "HEAD") if strings.TrimSpace(diff) != "" { t.Fatalf("uncommitted changes:\n%v", diff) } }) t.Run("TrackedGitFiles", func(t *testing.T) { diff := mustRunCommand(t, ".", "git", "ls-files", "--others", "--exclude-standard") if strings.TrimSpace(diff) != "" { t.Fatalf("untracked files:\n%v", diff) } }) } func mustInitDeps(t *testing.T) { check := func(err error) { t.Helper() if err != nil { t.Fatal(err) } } // Determine the directory to place the test directory. repoRoot, err := os.Getwd() check(err) testDir := filepath.Join(repoRoot, ".cache") check(os.MkdirAll(testDir, 0775)) // Travis-CI has a hard-coded timeout where it kills the test after // 10 minutes of a lack of activity on stdout. // We work around this restriction by periodically printing the timestamp. ticker := time.NewTicker(5 * time.Minute) done := make(chan struct{}) go func() { now := time.Now() for { select { case t := <-ticker.C: fmt.Printf("\tt=%0.fmin\n", t.Sub(now).Minutes()) case <-done: return } } }() defer close(done) defer ticker.Stop() // Delete the current directory if non-empty, // which only occurs if a dependency failed to initialize properly. var workingDir string defer func() { if workingDir != "" { os.RemoveAll(workingDir) // best-effort } }() // Delete other sub-directories that are no longer relevant. defer func() { subDirs := map[string]bool{"bin": true, "gocache": true, "gopath": true} subDirs["protobuf-"+protobufVersion] = true for _, v := range golangVersions { subDirs["go"+v] = true } now := time.Now() fis, _ := ioutil.ReadDir(testDir) for _, fi := range fis { if subDirs[fi.Name()] { os.Chtimes(filepath.Join(testDir, fi.Name()), now, now) // best-effort continue } if now.Sub(fi.ModTime()) < purgeTimeout { continue } fmt.Printf("delete %v\n", fi.Name()) os.RemoveAll(filepath.Join(testDir, fi.Name())) // best-effort } }() // The bin directory contains symlinks to each tool by version. // It is safe to delete this directory and run the test script from scratch. binPath := filepath.Join(testDir, "bin") check(os.RemoveAll(binPath)) check(os.Mkdir(binPath, 0775)) check(os.Setenv("PATH", binPath+":"+os.Getenv("PATH"))) registerBinary := func(name, path string) { check(os.Symlink(path, filepath.Join(binPath, name))) } // Download and build the protobuf toolchain. // We avoid downloading the pre-compiled binaries since they do not contain // the conformance test runner. workingDir = filepath.Join(testDir, "protobuf-"+protobufVersion) protobufPath = workingDir if _, err := os.Stat(protobufPath); err != nil { fmt.Printf("download %v\n", filepath.Base(protobufPath)) url := fmt.Sprintf("https://github.com/google/protobuf/releases/download/v%v/protobuf-all-%v.tar.gz", protobufVersion, protobufVersion) downloadArchive(check, protobufPath, url, "protobuf-"+protobufVersion) fmt.Printf("build %v\n", filepath.Base(protobufPath)) mustRunCommand(t, protobufPath, "./autogen.sh") mustRunCommand(t, protobufPath, "./configure") mustRunCommand(t, protobufPath, "make") mustRunCommand(t, filepath.Join(protobufPath, "conformance"), "make") } // The benchmark directory isn't present in the release download, // so fetch needed files directly. for _, path := range benchmarkProtos { src := fmt.Sprintf("https://raw.githubusercontent.com/protocolbuffers/protobuf/v%v/%v", protobufVersion, path) dst := filepath.Join(protobufPath, path) if _, err := os.Stat(dst); err != nil { downloadFile(check, dst, src) } } benchdataPath := filepath.Join(testDir, "benchdata") for _, path := range []string{ "benchmarks/datasets/google_message1/proto2/dataset.google_message1_proto2.pb", "benchmarks/datasets/google_message1/proto3/dataset.google_message1_proto3.pb", "benchmarks/datasets/google_message2/dataset.google_message2.pb", } { src := fmt.Sprintf("https://raw.githubusercontent.com/protocolbuffers/protobuf/v%v/%v", protobufVersion, path) dst := filepath.Join(benchdataPath, filepath.Base(path)) if _, err := os.Stat(dst); err != nil { downloadFile(check, dst, src) } } patchProtos(check, protobufPath) check(os.Setenv("PROTOBUF_ROOT", protobufPath)) // for generate-protos registerBinary("conform-test-runner", filepath.Join(protobufPath, "conformance", "conformance-test-runner")) registerBinary("protoc", filepath.Join(protobufPath, "src", "protoc")) workingDir = "" // Download each Go toolchain version. for _, v := range golangVersions { workingDir = filepath.Join(testDir, "go"+v) if _, err := os.Stat(workingDir); err != nil { fmt.Printf("download %v\n", filepath.Base(workingDir)) url := fmt.Sprintf("https://dl.google.com/go/go%v.%v-%v.tar.gz", v, runtime.GOOS, runtime.GOARCH) downloadArchive(check, workingDir, url, "go") } registerBinary("go"+v, filepath.Join(workingDir, "bin", "go")) } registerBinary("go", filepath.Join(testDir, "go"+golangLatest, "bin", "go")) registerBinary("gofmt", filepath.Join(testDir, "go"+golangLatest, "bin", "gofmt")) workingDir = "" // Travis-CI sets GOROOT, which confuses invocations of the Go toolchain. // Explicitly clear GOROOT, so each toolchain uses their default GOROOT. check(os.Unsetenv("GOROOT")) // Set a cache directory outside the test directory. check(os.Setenv("GOCACHE", filepath.Join(repoRoot, ".gocache"))) // Setup GOPATH for pre-module support (i.e., go1.10 and earlier). goPath = filepath.Join(testDir, "gopath") modulePath = strings.TrimSpace(mustRunCommand(t, testDir, "go", "list", "-m", "-f", "{{.Path}}")) check(os.RemoveAll(filepath.Join(goPath, "src"))) check(os.MkdirAll(filepath.Join(goPath, "src", filepath.Dir(modulePath)), 0775)) check(os.Symlink(repoRoot, filepath.Join(goPath, "src", modulePath))) mustRunCommand(t, repoRoot, "go", "mod", "tidy") mustRunCommand(t, repoRoot, "go", "mod", "vendor") check(os.Setenv("GOPATH", goPath)) } func downloadFile(check func(error), dstPath, srcURL string) { resp, err := http.Get(srcURL) check(err) defer resp.Body.Close() check(os.MkdirAll(filepath.Dir(dstPath), 0775)) f, err := os.Create(dstPath) check(err) _, err = io.Copy(f, resp.Body) check(err) } func downloadArchive(check func(error), dstPath, srcURL, skipPrefix string) { check(os.RemoveAll(dstPath)) resp, err := http.Get(srcURL) check(err) defer resp.Body.Close() zr, err := gzip.NewReader(resp.Body) check(err) tr := tar.NewReader(zr) for { h, err := tr.Next() if err == io.EOF { return } check(err) // Skip directories or files outside the prefix directory. if len(skipPrefix) > 0 { if !strings.HasPrefix(h.Name, skipPrefix) { continue } if len(h.Name) > len(skipPrefix) && h.Name[len(skipPrefix)] != '/' { continue } } path := strings.TrimPrefix(strings.TrimPrefix(h.Name, skipPrefix), "/") path = filepath.Join(dstPath, filepath.FromSlash(path)) mode := os.FileMode(h.Mode & 0777) switch h.Typeflag { case tar.TypeReg: b, err := ioutil.ReadAll(tr) check(err) check(ioutil.WriteFile(path, b, mode)) case tar.TypeDir: check(os.Mkdir(path, mode)) } } } // patchProtos patches proto files with v2 locations of Go packages. // TODO: Commit these changes upstream. func patchProtos(check func(error), repoRoot string) { javaPackageRx := regexp.MustCompile(`^option\s+java_package\s*=\s*".*"\s*;\s*$`) goPackageRx := regexp.MustCompile(`^option\s+go_package\s*=\s*".*"\s*;\s*$`) files := map[string]string{ "src/google/protobuf/any.proto": "google.golang.org/protobuf/types/known/anypb", "src/google/protobuf/api.proto": "google.golang.org/protobuf/types/known/apipb", "src/google/protobuf/duration.proto": "google.golang.org/protobuf/types/known/durationpb", "src/google/protobuf/empty.proto": "google.golang.org/protobuf/types/known/emptypb", "src/google/protobuf/field_mask.proto": "google.golang.org/protobuf/types/known/fieldmaskpb", "src/google/protobuf/source_context.proto": "google.golang.org/protobuf/types/known/sourcecontextpb", "src/google/protobuf/struct.proto": "google.golang.org/protobuf/types/known/structpb", "src/google/protobuf/timestamp.proto": "google.golang.org/protobuf/types/known/timestamppb", "src/google/protobuf/type.proto": "google.golang.org/protobuf/types/known/typepb", "src/google/protobuf/wrappers.proto": "google.golang.org/protobuf/types/known/wrapperspb", "src/google/protobuf/descriptor.proto": "google.golang.org/protobuf/types/descriptorpb", "src/google/protobuf/compiler/plugin.proto": "google.golang.org/protobuf/types/pluginpb", "conformance/conformance.proto": "google.golang.org/protobuf/internal/testprotos/conformance", "src/google/protobuf/test_messages_proto2.proto": "google.golang.org/protobuf/internal/testprotos/conformance", "src/google/protobuf/test_messages_proto3.proto": "google.golang.org/protobuf/internal/testprotos/conformance", } for _, p := range benchmarkProtos { files[p] = path.Dir("google.golang.org/protobuf/internal/testprotos/" + p) } for pbpath, gopath := range files { b, err := ioutil.ReadFile(filepath.Join(repoRoot, pbpath)) check(err) ss := strings.Split(string(b), "\n") // Locate java_package and (possible) go_package options. javaPackageIdx, goPackageIdx := -1, -1 for i, s := range ss { if javaPackageIdx < 0 && javaPackageRx.MatchString(s) { javaPackageIdx = i } if goPackageIdx < 0 && goPackageRx.MatchString(s) { goPackageIdx = i } } // Ensure the proto file has the correct go_package option. opt := `option go_package = "` + gopath + `";` if goPackageIdx >= 0 { if ss[goPackageIdx] == opt { continue // no changes needed } ss[goPackageIdx] = opt } else { // Insert go_package option before java_package option. ss = append(ss[:javaPackageIdx], append([]string{opt}, ss[javaPackageIdx:]...)...) } fmt.Println("patch " + pbpath) b = []byte(strings.Join(ss, "\n")) check(ioutil.WriteFile(filepath.Join(repoRoot, pbpath), b, 0664)) } } func mustRunCommand(t *testing.T, dir string, args ...string) string { t.Helper() stdout := new(bytes.Buffer) stderr := new(bytes.Buffer) cmd := exec.Command(args[0], args[1:]...) cmd.Dir = dir cmd.Env = append(os.Environ(), "PWD="+dir) cmd.Stdout = stdout cmd.Stderr = stderr if err := cmd.Run(); err != nil { t.Fatalf("executing (%v): %v\n%s%s", strings.Join(args, " "), err, stdout.String(), stderr.String()) } return stdout.String() } var benchmarkProtos = []string{ "benchmarks/benchmarks.proto", "benchmarks/datasets/google_message1/proto2/benchmark_message1_proto2.proto", "benchmarks/datasets/google_message1/proto3/benchmark_message1_proto3.proto", "benchmarks/datasets/google_message2/benchmark_message2.proto", "benchmarks/datasets/google_message3/benchmark_message3.proto", "benchmarks/datasets/google_message3/benchmark_message3_1.proto", "benchmarks/datasets/google_message3/benchmark_message3_2.proto", "benchmarks/datasets/google_message3/benchmark_message3_3.proto", "benchmarks/datasets/google_message3/benchmark_message3_4.proto", "benchmarks/datasets/google_message3/benchmark_message3_5.proto", "benchmarks/datasets/google_message3/benchmark_message3_6.proto", "benchmarks/datasets/google_message3/benchmark_message3_7.proto", "benchmarks/datasets/google_message3/benchmark_message3_8.proto", "benchmarks/datasets/google_message4/benchmark_message4.proto", "benchmarks/datasets/google_message4/benchmark_message4_1.proto", "benchmarks/datasets/google_message4/benchmark_message4_2.proto", "benchmarks/datasets/google_message4/benchmark_message4_3.proto", }