Go 语言测试

运行 go test 命令执行当前目录下的测试代码寻找 *_test.go 文件
并在这些文件中寻找符合 TestXxx(*testing.T){} 函数和参数（接收t *testing.T 参数的函数命名为 TestXxx 以Xxx 是任何不以小写字符开头的名字）
测试代码不影响正常的编译过程只在执行 go test 时被使用

黑盒测试包

The black box test package
Go 语言测试和要被测试的代码在同一个包中(被测系统) 才能访问内部实现细节的代码
为了支持黑盒测试 go test 支持使用以 _test 后缀命名并可被编译成独立的包的形式// in example.go
package example
var start int
func Add(n int) int {
    start += n
    return start
}// in example_test.go
package example_test
import (
    "testing"
    . "bitbucket.org/splice/blog/example"
)
func TestAdd(t *testing.T) {
    got := Add(1)
    if got != 1 {
        t.Errorf("got %d, want 1", got)
    }
}
黑盒测试模式也能被用来打破循环导入的问题
在被测试的包 a 被 b 导入且 a 的测试也需要导入 b 时 - 测试可以被移动到 a_test 包然后可以（同时）导入 a 和 b 这样就没有循环导入的问题

跳过测试

Skipping tests
测试要求要有特定的上下文环境一些测试需要调用外部命令使用特殊文件或需要可以被设置的环境变量
条件无法满足时不想让那些测试失败可简单地跳过那些测试
func TestSomeProtectedResource(t *testing.T) {
    if os.Getenv("SOME_ACCESS_TOKEN") == "" {
        t.Skip("skipping test; $SOME_ACCESS_TOKEN not set")
    }
    // ... the actual test
}
如果 go test -v 被调用（那个冗余 -v 标志）输出将会提醒已跳过的测试：
=== RUN TestSomeProtectedResource
--- SKIP: TestSomeProtectedResource (0.00 seconds)
example_test.go:17: skipping test; $SOME_ACCESS_TOKEN not set
用 -short 命令行标志来实现跳过的特性如果标志被设置反映到代码 testing.Short() 将返回 true（像 -v 标志如果被设置判断 testing.Verbose() 可打印额外调试日志）
当测试运行较长时间而很着急可执行 go test -short
提供这个包的开发者又刚好实现了这个功能运行时间长的测试会被跳过这是从源码安装时 Go 测试被执行的样子这里有 stdlib 库中运行时间较长的测试被跳过的例子
func TestCountMallocs(t *testing.T) {
    if testing.Short() {
        t.Skip("skipping malloc count in short mode")
    }
    // rest of test...
}
跳过只是可选项 -short 标志只是一个标示具体还依赖于开发者可以选择（这种标示生效时是否）运行的测试避免运行比较慢的断言被执行
还有 -timeout 标志能够用来强制退出限定时间内没运行完的测试 go test -timeout 1s 以执行下面的测试
func TestWillTimeout(t *testing.T) {
    time.Sleep(2 * time.Second)
    // pass if timeout > 2s
}会有如下输出（截断）
=== RUN TestWillTimeout
panic: test timed out after 1s
如果想执行特定的测试函数而不是执行全部的测试集只需要运行 go test -run TestNameRegexp

并行执行测试

Parallelizing tests
默认指定包的测试按照顺序执行但也可以通过在测试的函数内部使用 t.Parallel() 标志某些测试可以被安全的并发执行（默认假设参数名为 t）
并行执行时只有当那些被标记为并行的测试才会被并行执行所以只有一个测试函数时没意义它应该在测试函数体中第一个被调用（在任何需要跳过的条件之后）因为它会重置测试时间
func TestParallel(t *testing.T) {
    t.Parallel()
    // actual test...
}
在并发情况下同时运行的测试的数量默认取决于 GOMAXPROCS 它可以通过 -parallel n 被指定（go test -parallel 4）
另外一个可以实现并行的方法尽管不是函数级粒度但却是包级粒度就是类似这样执行 go test p1 p2 p3（也就是说同时调用多个测试包）在这种情况下包会被先编译并同时被执行当然这对于总的时间来说是有好处的但它也可能会导致错误变得具有不可预测性比如一些资源被多个包同时使用时（例如一些测试需要访问数据库并删除一些行而这些行又刚好被其他的测试包使用的话）
为了保持可控性 -p 标志可以用来指定编译和测试的并发数当仓库中有多个测试包并且每个包在不同的子目录中
可以执行所有包的命令是 go test ./... 这包含当前目录和所有子目录没有带 -p 标志执行时总的运行时间应该接近于运行时间最长的包的时间（加上编译时间）
运行 go test -p 1 ./... 使编译和测试工具只能在一个包中执行时总的时间应该接近于所有独立的包测试的时间加上编译的时间的总和
可以自己试试执行 go test -p 3 ./... 看一下对运行时间的影响
另外一个可以并行化的地方在包的代码里面多亏了 Go 非常棒的并行原语实际上除非 GOMAXPROCS 通过环境变量或者在代码中显式设置为 GOMAXPROCS=1
否则包中一个goroutines 都没有用是不太常见的想要使用 2 个 CPU 可以执行 GOMAXPROCS=2
go test 想要使用 4 个 CPU 可以执行 GOMAXPROCS=4
go test 还有更好的方法 go test -cpu=1,2,4
将会执行 3 次其中 GOMAXPROCS 值分别为 1 2 和 4

-cpu 标志
搭配数据竞争的探测标志 -race 竞争探测是很神奇的工具在以高并发为主的开发中不得不使用这个工具（防止死锁问题）
感兴趣阅读 Go 官方博客的 race-detector

go test 工具支持以与测试函数相似的方式运行基准测试和可断言示例（！）
godoc 工具能理解例子中的语法并将其包含在生成的文档中
还有代码覆盖率和性能测试测试工具也支持这两个功能对于感兴趣的访问 The cover story   http://blog.golang.org/cover
和 Profiling Go programs http://blog.golang.org/profiling-go-programs 爬墙不然看不到

在写自己的测试代码前建议看标准库
testing/iotest
testing/quick
net/http/httptest 软件包