--- /dev/null
+// Copyright 2018 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.
+
+package godoc
+
+import (
+ "go/build"
+ "testing"
+)
+
+func TestParseVersionRow(t *testing.T) {
+ tests := []struct {
+ row string
+ want versionedRow
+ }{
+ {
+ row: "# comment",
+ },
+ {
+ row: "",
+ },
+ {
+ row: "pkg archive/tar, type Writer struct",
+ want: versionedRow{
+ pkg: "archive/tar",
+ kind: "type",
+ name: "Writer",
+ },
+ },
+ {
+ row: "pkg archive/tar, type Header struct, AccessTime time.Time",
+ want: versionedRow{
+ pkg: "archive/tar",
+ kind: "field",
+ structName: "Header",
+ name: "AccessTime",
+ },
+ },
+ {
+ row: "pkg archive/tar, method (*Reader) Read([]uint8) (int, error)",
+ want: versionedRow{
+ pkg: "archive/tar",
+ kind: "method",
+ name: "Read",
+ recv: "*Reader",
+ },
+ },
+ {
+ row: "pkg archive/zip, func FileInfoHeader(os.FileInfo) (*FileHeader, error)",
+ want: versionedRow{
+ pkg: "archive/zip",
+ kind: "func",
+ name: "FileInfoHeader",
+ },
+ },
+ {
+ row: "pkg encoding/base32, method (Encoding) WithPadding(int32) *Encoding",
+ want: versionedRow{
+ pkg: "encoding/base32",
+ kind: "method",
+ name: "WithPadding",
+ recv: "Encoding",
+ },
+ },
+ }
+
+ for i, tt := range tests {
+ got, ok := parseRow(tt.row)
+ if !ok {
+ got = versionedRow{}
+ }
+ if got != tt.want {
+ t.Errorf("%d. parseRow(%q) = %+v; want %+v", i, tt.row, got, tt.want)
+ }
+ }
+}
+
+// hasTag checks whether a given release tag is contained in the current version
+// of the go binary.
+func hasTag(t string) bool {
+ for _, v := range build.Default.ReleaseTags {
+ if t == v {
+ return true
+ }
+ }
+ return false
+}
+
+func TestAPIVersion(t *testing.T) {
+ av, err := parsePackageAPIInfo()
+ if err != nil {
+ t.Fatal(err)
+ }
+ for _, tc := range []struct {
+ kind string
+ pkg string
+ name string
+ receiver string
+ want string
+ }{
+ // Things that were added post-1.0 should appear
+ {"func", "archive/tar", "FileInfoHeader", "", "1.1"},
+ {"type", "bufio", "Scanner", "", "1.1"},
+ {"method", "bufio", "WriteTo", "*Reader", "1.1"},
+
+ {"func", "bytes", "LastIndexByte", "", "1.5"},
+ {"type", "crypto", "Decrypter", "", "1.5"},
+ {"method", "crypto/rsa", "Decrypt", "*PrivateKey", "1.5"},
+ {"method", "debug/dwarf", "GoString", "Class", "1.5"},
+
+ {"func", "os", "IsTimeout", "", "1.10"},
+ {"type", "strings", "Builder", "", "1.10"},
+ {"method", "strings", "WriteString", "*Builder", "1.10"},
+
+ // Things from package syscall should never appear
+ {"func", "syscall", "FchFlags", "", ""},
+ {"type", "syscall", "Inet4Pktinfo", "", ""},
+
+ // Things added in Go 1 should never appear
+ {"func", "archive/tar", "NewReader", "", ""},
+ {"type", "archive/tar", "Header", "", ""},
+ {"method", "archive/tar", "Next", "*Reader", ""},
+ } {
+ if tc.want != "" && !hasTag("go"+tc.want) {
+ continue
+ }
+ if got := av.sinceVersionFunc(tc.kind, tc.receiver, tc.name, tc.pkg); got != tc.want {
+ t.Errorf(`sinceFunc("%s", "%s", "%s", "%s") = "%s"; want "%s"`, tc.kind, tc.receiver, tc.name, tc.pkg, got, tc.want)
+ }
+ }
+}