Go包之间如何共享测试接口？

Question

Go 不会在不同包的测试文件之间共享代码，因此不会自动重用测试接口的定义。我们如何在实践中解决这个问题？

使用 `testing/quick` 的示例：

foo/foo.go:

package foo

type Thing int

const (
  X Thing = iota
  Y
  Z
)

bar/bar.go:

package bar

import (
  "foo"
)

type Box struct {
  Thing foo.Thing
}

我们要属性测试foo，所以我们在Thing上定义testing/quick.Generate:

foo_test.go:

package foo

import (
  "math/rand"
  "reflect"
  "testing"
  "testing/quick"
  "time"
)

func (_ Thing) Generate(r *rand.Rand, sz int) reflect.Value {
  return reflect.ValueOf(Thing(r.Intn(3)))
}

func TestGenThing(t *testing.T) {
  r := rand.New(rand.NewSource(time.Now().UTC().UnixNano()))
  for i := 0; i < 5; i++ {
    val, _ := quick.Value(reflect.TypeOf(Thing(0)), r)
    tng, _ := val.Interface().(Thing)
    t.Logf("%#v\n", tng)
  }
}

quick.Value returns Things 在 [0,3) 范围内，符合预期：

$ go test -v foo
=== RUN   TestGenThing
--- PASS: TestGenThing (0.00s)
        foo_test.go:20: 0
        foo_test.go:20: 1
        foo_test.go:20: 2
        foo_test.go:20: 1
        foo_test.go:20: 2
PASS
ok      foo     0.026s

我们属性也测试一下 bar：

package bar

import (
  "math/rand"
  "reflect"
  "testing"
  "testing/quick"
  "time"

  "foo"
)

func (_ Box) Generate(r *rand.Rand, sz int) reflect.Value {
  val, _ := quick.Value(reflect.TypeOf(foo.Thing(0)), r)
  tng, _ := val.Interface().(foo.Thing)
  return reflect.ValueOf(Box{tng})
}

func TestGenBox(t *testing.T) {
  r := rand.New(rand.NewSource(time.Now().UTC().UnixNano()))
  for i := 0; i < 5; i++ {
    val, _ := quick.Value(reflect.TypeOf(Box{}), r)
    box, _ := val.Interface().(Box)
    t.Logf("%#v\n", box)
  }
}

但是Box.Generate坏了。 foo_test.go 对 bar_test.go 不可用，因此 quick.Value() 不使用 Thing.Generate():

$ GOPATH=$PWD go test -v bar
=== RUN   TestGenBox
--- PASS: TestGenBox (0.00s)
        bar_test.go:24: bar.Box{Thing:3919143124849004253}
        bar_test.go:24: bar.Box{Thing:-3486832378211479055}
        bar_test.go:24: bar.Box{Thing:-3056230723958856466}
        bar_test.go:24: bar.Box{Thing:-847200811847403542}
        bar_test.go:24: bar.Box{Thing:-2593052978030148925}
PASS
ok      bar     0.095s

有解决办法吗？人们如何在实践中使用 testing/quick（或任何其他带有接口的测试库）？

Answer 1

包之间共享的任何代码都必须在非测试文件中。但这并不意味着它必须包含在任何最终版本中；当运行测试时，您可以使用 build constraints to exclude the files from normal builds, and build tags 来包含它们。例如，您可以将共享测试代码放在前缀为：

的文件中

//+build testtools

package mypackage

（但未命名为 _test.go）。当您构建时，这将不会包含在构建中。当你测试时，你会使用类似的东西：

go test -tags "testtools" ./...

这将在构建中包含受限文件，从而使共享代码可用于测试。

Go包之间如何共享测试接口？

How to share test interfaces between Go packages?

testing

go

quickcheck

property-testing

使用 `testing/quick` 的示例：

Go包之间如何共享测试接口？

How to share test interfaces between Go packages?

testing

go

quickcheck

property-testing

使用 testing/quick 的示例：

使用 `testing/quick` 的示例：