golang 单元测试(一)

单元测试函数类型

Test(功能测试)

函数规则:

函数名: TestXxxx , 以Test为前缀。Xxxx以大写字母开头
参数类型: *testing.T

func TestXxxx(t *testing.T){...}

编写一个简单的例子,假设有下面一个待测函数:



func add(a, b int) int {

	return a + b

}

测试代码如下:

import "testing"

func TestAdd(t *testing.T) {

	cases := []struct {

		first    int

		second   int

		excepted int

	}{

		{1, 2, 3},

		{1, 2, 4},

	}

	for _, c := range cases {

		result := add(c.first, c.second)

		if result != c.excepted {

			t.Fatalf("add function failed, first: %d, second:%d, execpted:%d, result:%d", c.first, c.second, c.excepted, result)

		}

	}

}

执行 go go test -v 结果如下:

=== RUN   TestAdd

--- FAIL: TestAdd (0.00s)

    example_test.go:30: add function failed, first: 1, second:2, execpted:4, result:3

FAIL

exit status 1

FAIL    gotest/gotest   0.006s

第二个测试用例出错,未能通过单元测试,需要检查测试数据或者被测试函数是否符合我们的预期。

从上述过程可以看出, TestXxxx 可以理解为功能性测试,其目的在于测试函数的功能性是否正确, 应当编写尽可能多的测试用例来验证被测函数的正确性。

Benchmark(基准测试)

函数规则:

函数名: BenchmarkXxxx, 以Benchmark为前缀。Xxxx以大写字母开头
参数类型: *testing.B

func BenchmarkXxx(b *testing.B){...}

性能测试函数如下:

func BenchmarkAdd(b *testing.B) {

	for i := 0; i < b.N; i++ {

		add(1, 2)

	}

}

执行 go test -bench=. -run=^$,结果如下:

goos: darwin

goarch: amd64

pkg: gotest/gotest

BenchmarkAdd-8   	2000000000	         0.32 ns/op

PASS

ok  	gotest/gotest	0.667s

测试结果说明:

-8 表示 8个逻辑cpu个数(下文会解释)
2000000000 表示执行了 2000000000 次
0.32 ns/op 每次操作耗时
0.667s 是总时长

性能测试函数计时器:

当性能测试函数中有一些额外的初始化操作时,可以通过启停计时器来屏蔽这些操作对最终性能测试的影响。简单例子如下:

func BenchmarkAdd(b *testing.B) {

	time.Sleep(10 * time.Second)

	for i := 0; i < b.N; i++ {

		add(1, 2)

	}

}

执行命令go test -bench=.,结果如下:

goos: darwin

goarch: amd64

pkg: gotest/gotest

BenchmarkAdd-8   	       1	10004479538 ns/op

PASS

ok  	gotest/gotest	10.011s

单个测试函数耗时为 10004479538 ns,同时我们也可以看到,这个函数执行一次就已经达到了最大上限时间。

加上时间计数器:

func BenchmarkAdd(b *testing.B) {

	b.StopTimer()

	time.Sleep(10 * time.Second)

	b.StartTimer()

	for i := 0; i < b.N; i++ {

		add(1, 2)

	}

}

测试结果如下:

goos: darwin

goarch: amd64

pkg: gotest/gotest

BenchmarkAdd-8   	2000000000	         0.34 ns/op

PASS

ok  	gotest/gotest	60.751s

单次执行耗时为: 0.34 ns 了。

Tips:

对于 b.N 参数而言, test 命令先会尝试设置为1,之后执行函数。如果测试函数没有达到执行上限的话, test 函数会增大,之后再次执行测试函数,如此往复,直到执行时间大于或者等于上限时间为止。上限时间可以使用 -benchtime设定

Example(示例测试)

函数规则:

函数名: ExampleXxx
输出内容至标准输出,参数列表没有限制

示例测试函数如下:

func Println(content string) {

	fmt.Println("The output of\nthis example.")

}

func ExamplePrintln() {

	Println("The output of\nthis example.")

	// Output: The output of

	// this example.

}

go test 命令会检测实际输出与注释中的期望输出是否一致, 一致则测试通过,不一致则测试失败。

go test 常用参数

-cpu: 设置测试最大 cpu 逻辑数(也就是 GPM 中 P, 最大并行执行的 gorouting 数量, 默认等于 cpu 核数)
-count: 设置执行测试函数的次数, 默认为 1
-run: 执行功能测试函数, 支持正则匹配, 可以选择测试函数或者测试文件来仅测试单个函数或者单个文件
-bench: 执行基准测试函数, 支持正在匹配
-benchtime: 基准测试最大探索时间上限
-parallel: 设置同一个被测试代码包中的功能测试函数的最大并发执行数
-v: 是展示测试过程信息

更多的参数可以参考下文的官方文档

参考

golang 官方文档

极客时间

巴特西

golang 单元测试(一)

单元测试函数类型

Test(功能测试)

Benchmark(基准测试)

性能测试函数计时器:

Tips:

Example(示例测试)

go test 常用参数

参考

最新文章

热门文章