Go-知识测试-子测试
- [1. 介绍](#1. 介绍)
- [2. 例子](#2. 例子)
- [3. 子测试命名规则](#3. 子测试命名规则)
- [4. 选择性执行](#4. 选择性执行)
- [5. 子测试并发](#5. 子测试并发)
- [6. testing.T.Run](#6. testing.T.Run)
- [7. testing.T.Parallel](#7. testing.T.Parallel)
- [8. 子测试适用于单元测试](#8. 子测试适用于单元测试)
- [9. 子测试适用于性能测试](#9. 子测试适用于性能测试)
- [10. 总结](#10. 总结)
-
- [10.1 启动子测试 Run](#10.1 启动子测试 Run)
- [10.2 启动并发测试 Parallel](#10.2 启动并发测试 Parallel)
建议先看:https://blog.csdn.net/a18792721831/article/details/140062769
1. 介绍
子测试提供了一种在一个测试函数中执行多个测试的能力,可以自己编排执行顺序,或者做一些初始化等操作。
2. 例子
比如如下代码:
Go
import "testing"
func SubA(t *testing.T) {
t.Log("test A " + t.Name())
}
func SubB(t *testing.T) {
t.Log("test B " + t.Name())
}
func SubC(t *testing.T) {
t.Log("test C " + t.Name())
}
func TestSub(t *testing.T) {
t.Run("name=A", SubA)
t.Run("name=B", SubB)
t.Run("name=C", SubC)
}
使用go test -v xx_test.go
执行
3. 子测试命名规则
Run()方法的第一个参数作为子测试的名字,这里只是本层级的名字。
实际上子测试的内部命名规则是: <父测试名字>/<传递给Run的名字>
比如我们在B里面在调用A:
执行后:
name具有传递性
4. 选择性执行
在上面我们有 name=A,name=B,name=C 三个测试,如果只是想执行A呢
使用go test -v xx_test.go -run TestSub/name=A
选择性执行的字符串,是包含匹配,不是严格的正则匹配。
5. 子测试并发
可以看到,前面的子测试都是根据代码顺序执行,串行执行,并没有并发。
使用 t.Parallel
可以让当前测试函数允许并发。
比如如下例子不加并发的时候:
Go
import (
"testing"
"time"
)
func SubA(t *testing.T) {
t.Log("test A " + t.Name())
time.Sleep(time.Second*3)
}
func SubB(t *testing.T) {
t.Log("test B " + t.Name())
time.Sleep(time.Second*2)
}
func SubC(t *testing.T) {
time.Sleep(time.Second*1)
t.Log("test C " + t.Name())
}
func TestSub(t *testing.T) {
t.Run("name=A", SubA)
t.Run("name=B", SubB)
t.Run("name=C", SubC)
}
执行后用时超过6秒
允许并发:
Go
import (
"testing"
"time"
)
func SubA(t *testing.T) {
t.Parallel()
t.Log("test A " + t.Name())
time.Sleep(time.Second * 3)
}
func SubB(t *testing.T) {
t.Parallel()
t.Log("test B " + t.Name())
time.Sleep(time.Second * 2)
}
func SubC(t *testing.T) {
t.Parallel()
time.Sleep(time.Second * 1)
t.Log("test C " + t.Name())
}
func TestSub(t *testing.T) {
t.Run("name=A", SubA)
t.Run("name=B", SubB)
t.Run("name=C", SubC)
}
A最先被调度,但是确是最后执行完毕。
需要注意的是,当开启子测试并发后,调用了子测试后,父测试的代码和子测试代码执行顺序就是随机的了。
所以如果在主测试中需要做一些初始化,然后在执行子测试,那么需要注意,有可能初始化还未完成,子测试已经开始执行了。
6. testing.T.Run
Go
// 将运行f作为名为name的t的子测试。它在一个单独的goroutine中运行f
// 并且阻塞直到f返回或调用t。并行成为并行测试。
// 运行报告f是否成功(或者至少在调用t.Parallel之前没有失败)。
//
// Run可以从多个goroutine同时调用,但所有此类调用
// 必须在t的外部测试函数返回之前返回。
func (t *T) Run(name string, f func(t *T)) bool {
atomic.StoreInt32(&t.hasSub, 1)
testName, ok, _ := t.context.match.fullName(&t.common, name)
if !ok || shouldFailFast() {
return true
}
//记录此调用点的堆栈跟踪,以便如果子测试
//在单独的堆栈中运行的函数被标记为助手,我们可以
//继续将堆栈遍历到父测试中。
var pc [maxStackLen]uintptr
n := runtime.Callers(2, pc[:])
t = &T{
common: common{
barrier: make(chan bool),
signal: make(chan bool, 1),
name: testName,
parent: &t.common,
level: t.level + 1,
creator: pc[:n],
chatty: t.chatty,
},
context: t.context,
}
t.w = indenter{&t.common}
if t.chatty != nil {
t.chatty.Updatef(t.name, "=== RUN %s\n", t.name)
}
//而不是在调用之前减少此测试的运行计数
//tRunner并在之后增加它,我们依靠tRunner保持
//计数正确。这样可以确保运行一系列顺序测试
//而不会被抢占,即使它们的父级是并行测试。这
//如果*parallel==1,则可以特别减少意外。
go tRunner(t, f)
if !<-t.signal {
//此时,FailNow很可能是在
//其中一个子测验的家长测验。继续中止链的上行。
runtime.Goexit()
}
return !t.failed
}
在testing.Run中,会创建一个testing.T对象,然后将调用者作为parent,然后调用testing.tRunner执行。
同时会设置父测试有子测试的标志:hasSub。
一个树形结构,父测试不知道有哪些子测试,但是父测试知道需要等待子测试执行完成。
7. testing.T.Parallel
Go
// 与此测试并行运行的并行信号(且仅与)
// 其他平行测试。当测试由于使用而多次运行时
// -test.count或-test.cpu,单个测试的多个实例从未在中运行
// 彼此平行。
func (t *T) Parallel() {
if t.isParallel {
panic("testing: t.Parallel called multiple times")
}
if t.isEnvSet {
panic("testing: t.Parallel called after t.Setenv; cannot set environment variables in parallel tests")
}
t.isParallel = true
if t.parent.barrier == nil {
// T.Parallel has no effect when fuzzing.
// Multiple processes may run in parallel, but only one input can run at a
// time per process so we can attribute crashes to specific inputs.
return
}
//我们不想把等待串行测试的时间包括在内
//在测试持续时间内。记录到目前为止经过的时间,并重置
//计时器之后。
t.duration += time.Since(t.start)
//添加到要由父级发布的测试列表中。
t.parent.sub = append(t.parent.sub, t)
t.raceErrors += race.Errors()
if t.chatty != nil {
//不幸的是,即使PAUSE表示命名测试是*no
//运行时间较长*,cmd/test2json将其解释为更改活动测试
//用于日志解析。我们可以修复cmd/test2json,但是
//不会修复已经shell的第三方工具的现有部署
//向外扩展到cmd/test2json的旧版本------因此仅修复cmd/test1json
//目前还不够。
t.chatty.Updatef(t.name, "=== PAUSE %s\n", t.name)
}
t.signal <- true // Release calling test.
<-t.parent.barrier // Wait for the parent test to complete.
t.context.waitParallel()
if t.chatty != nil {
t.chatty.Updatef(t.name, "=== CONT %s\n", t.name)
}
t.start = time.Now()
t.raceErrors += -race.Errors()
}
设置当前testing.T的并发状态为true,因为Parallel在子测试中调用的,因此testing.T是子测试的T。
testing.Run是在父测试中调用的,因此testing.T是父测试。
将当前子测试加入到父测试的sub列表中,由父测试启动。
8. 子测试适用于单元测试
在testing.common中,hasSub表示是否有子测试,sub 则是子测试列表(testing.T)
在testing.tRunner中,有对子测试相关的支持
if len(t.sub) > 0 表示,如果有子测试,那么触发子测试执行,并且等待子测试执行完成。
else if t.isParallel 表示,如果是允许并发的,那么释放锁。
testing.tRunner 不管是父测试,还是子测试,都会执行。
9. 子测试适用于性能测试
在testing.B.Run中,设置父测试的hasSub标志为1。
并且创建一个testing.B,通过先调用testing.B.run1在调用testing.B.run执行。
并且子测试的数据会附加到父测试的报告中。
10. 总结
10.1 启动子测试 Run
Run 函数启动一个单独的协程来运行名字为name的子测试f,并且会阻塞等待其执行结束,除非子测试f显式调用Parallel将自己编程一个可并行的测试,最后返回bool类型的测试结果。
所有的测试,都是由TestMain使用Run方法直接或者间接启动。
每启动一个子测试,都会创建一个testing.T或者testing.B变量,该变量集成当前测试的部分属性,然后以新的
协程执行,当前测试会在子测试结束后返回子测试的结果。
子测试退出条件要么是子测试执行结束,要么是子测试设置了Parallel,否则是异常退出。
10.2 启动并发测试 Parallel
Parallel方法将当前测试加入并发队列。
启动并发测试,在排队等待过程中,消耗的时间不能统计到测试的耗时内,所以在测试真正被并发调度后,清空等待时间。