Go 测试高级窍门和技巧

栏目: 编程工具 · 发布时间: 5年前

内容简介:2017 年 2 月 1 日 · 5 min 阅读这篇文章基于我在我读了很多博客,看了很多演讲并把所有这些窍门和技巧都集中在一个地方。首先我想感谢那些提出这些想法并把它们分享到社区的人。我从下面的这些工作中借鉴了资料和示例:

2017 年 2 月 1 日 · 5 min 阅读

这篇文章基于我在 维尔纽斯的 Golang 交流会 上的演讲。

我读了很多博客,看了很多演讲并把所有这些窍门和技巧都集中在一个地方。首先我想感谢那些提出这些想法并把它们分享到社区的人。我从下面的这些工作中借鉴了资料和示例:

在阅读这篇之前,我希望你已经知道如何做表格驱动的测试以及使用 interface 进行 模拟 (mock)/ 桩 (stub) 注入。这里是一些窍门:

窍门 1. 不使用框架

来自 Ben Johnson 的窍门。Go 有一个着实很棒的测试框架,它让你能够使用同样的语言编写测试代码,无需学习任何的库或测试引擎,直接用! 也可以参考 Ben Johnson 的 帮助函数 ,可以帮你省一些代码行数。

窍门 2. 使用 "_test" 包名

Ben Johnson's tip. Using *_test package doesn't allow you to enter unexported identifiers. This puts you into position of a package's user, allowing you to check whether package's public API is useful.

来自 Ben Johnson 的提示。使用 *_test 包名,你无法使用包中未导出的标识符。这样在测试中,你就是包的使用者,让你更好地检查包的公有 API 是否可用。

窍门 3. 避免全局常量

来自 Mitchell Hashimoto 的窍门。如果你使用了全局的常量标识符,测试时将无法改变它们的行为。这个窍门的例外是全局常量对默认值是有用的。查看下面的例子:

// Bad, tests cannot change value!
const port = 8080
// Better, tests can change the value.
var port = 8080
// Even better, tests can configure Port via struct.
const defaultPort = 8080
type AppConfig {
	Port int // set it to defaultPort using constructor.
}

这里是一些技巧,希望能够让你的测试代码更好:

技巧 1. Test fixtures

这个技巧在 标准库 中用到。这是我从 Mitchell Hashimoto 和 Dave Cheney 的作品中学到的。go test 很好地支持从文件中加载测试数据。第一,go build 忽略名为 testdata 的文件夹。第二,当 ge test 运行时,它将当前目录设置为包目录。这使得你可以使用相对路径 testdata 目录作为存储和加载数据的地方。这是一个例子:

func helperLoadBytes(t *testing.T, name string) []byte {
	path := filepath.Join("testdata", name) // relative path
	bytes, err := ioutil.ReadFile(path)
	if err != nil {
		t.Fatal(err)
	}
	return bytes
}

技巧 2. Golden 文件

这个技巧也在 标准库 中被用到,但我是从 Mitchell Hashimoto 的演讲中学到的。这里的思想是将期望输出存储在一个名为 .golden 的文件中并提供一个 flag 来更新它。这里是例子:

var update = flag.Bool("update", false, "update .golden files")
func TestSomething(t *testing.T) {
	actual := doSomething()
	Golden := filepath.Join("testdata", tc.Name+ ".golden" )
	if *update {
		ioutil.WriteFile(golden, actual, 0644)
	}
	expected, _ := ioutil.ReadFile(golden)

	if !bytes.Equal(actual, expected) {
		// FAIL!
	}
}

这个技巧使你得以测试复杂的输出而无需硬编码。

技巧 3. 测试帮助函数

Mitchell Hashimoto 的技巧。有时候测试代码变得有点复杂。当你需要为测试案例做合适的配置,经常包含很多无关的 err 检查,例如检查测试文件是否正确加载,检查数据是否可以解析成 JSON,等等。这些代码很快就变得十分丑陋!

为了解决这个问题,你需要将无关的代码分离到帮助函数里。这些函数永远不应该返回 error,如果有一些操作失败,应该将 *testing.T 作为参数并让测试失败。

还有,如果你的帮助函数需要在后面做一些清理,你应该返回一个做清理工作的函数。看看下面的例子:

func testChdir(t *testing.T, dir string) func() {
	old, err := os.Getwd()
	if err != nil {
		t.Fatalf("err: %s", err)
	}
	if err := os.Chdir(dir); err != nil {
		t.Fatalf("err: %s", err)
	}
	return func() {
		if err := os.Chdir(old); err != nil {
			 t.Fatalf("err: %s", err)
		}
	}
}
func TestThing(t *testing.T) {
	defer testChdir(t, "/other")()
	// ...
}

( 注:这个例子摘自 Mitchell Hashimoto - Advanced Testing with Go 的演讲 )。这个例子里用到了另一个很酷的技巧就是 defer 。在这段代码中 defer testChdir(t, “ /other")() 执行 testChdir 函数并将其返回的清理函数延迟执行。

技巧 4. 子进程:真实调用

有时候你需要测试依赖于可执行程序的代码。例如,你的程序使用 Git。测试这段代码的一个办法是模拟 Git 的行为,但那真的很难!另一个办法是真正调用 Git 可执行程序。但如果执行测试的用户没有安装 Git 怎么办?

这个技巧解决了检查系统是否有安装 Git 的问题,如果没有安装则跳过测试。例子如下:

var testHasGit bool
func INIt() {
	if _, err := exec.LookPath("git"); err == nil {
		testHasGit = true
	}
}
func TestGitGetter(t *testing.T) {
	if !testHasGit {
		t.Log("git not found, skipping")
		t.Skip()
	}
	// ...
}

( 注:这个例子摘自 Mitchell Hashimoto - Advanced Testing with Go 的演讲。)

技巧 5. 子进程:模拟

Andrew Gerrand / Mitchell Hashimoto 的技巧。下面的技巧让我们模拟一个子进程,无需跳过测试代码。这个例子也可以在 标准库测试 中看到。假设我们要测试 Git 失败的场景。看看这个例子:

func CrashingGit() {
	os.Exit(1)
}
func TestFailingGit(t *testing.T) {
	if os.Getenv("BE_CRASHING_GIT") == "1" {
		CrashingGit()
		return
	}
	cmd := exec.Command(os.Args[0], "-test.run=TestFailingGit")
	cmd.Env = append(os.Environ(), "BE_CRASHING_GIT=1")
	err := cmd.Run()
	if e, ok := err.(*exec.ExitError); ok && !e.Success() {
		return
	}
	t.Fatalf("Process ran with err %v, want os.Exit(1)", err)
}

这里的思想把 Go 测试框架作为稍做修改( os.Args[0] - 是生成的 Go test 二进制)的子进程运行。稍做修改是为了在环境变量为 BE_CRASHING_GIT=1 时运行同样的测试( -test.run=TestFailingGit 的部分),这样你可以区分何时作为子进程运行,何时正常执行。

技巧 6. 将模拟、帮助函数放在 testing.go 文件中

Hashimoto 提的一个有趣的建议是将帮助函数,fixtures,桩都导出并放在 testing.go 文件中。(注意 testing.go 文件被当成正常的代码对待,而不是测试代码。)这使你可以在不同的包中使用模拟和帮助函数,包的使用者在他们的代码中也可以使用它们。

技巧 7. 处理那些运行慢的测试

Peter Bourgon 的技巧。当你有一些运行很慢的测试时,等待所有测试完成会变得很烦人,特别是当你想立刻知道编译是否成功时。这个问题的解决办法是将那些运行慢的测试移到 *_integration_test.go 文件中并在文件的开头添加编译选项。例如:

// +build integration

这样 go test 就不会包含有编译选项的那些测试。为了执行它们,你需要在 go test 命令中指定编译选项。

go test -tags=integration

我个人使用 alias,用于运行当前包以及子包里除 vendor 目录以外的所有测试。

alias gtest="go test \$(go list ./ … | grep -v /vendor/)
-tags=integration"

这个 alias 兼容 -v 选项。

$ gtest
…
$ gtest -v
…

感谢阅读!如果你有任何问题或想要提供反馈,可以在我的 blog https://povilasv.me 找我或者通过 Twitter @PofkeVe 跟我联系。


以上所述就是小编给大家介绍的《Go 测试高级窍门和技巧》,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对 码农网 的支持!

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

Python编程快速上手

Python编程快速上手

Albert Sweigart / 王海鹏 / 人民邮电出版社 / 2016-7-1 / 69.00元

如今,人们面临的大多数任务都可以通过编写计算机软件来完成。Python是一种解释型、面向对象、动态数据类型的高级程序设计语言。通过Python编程,我们能够解决现实生活中的很多任务。 本书是一本面向实践的Python编程实用指南。本书的目的,不仅是介绍Python语言的基础知识,而且还通过项目实践教会读者如何应用这些知识和技能。本书的首部分介绍了基本Python编程概念,第二部分介绍了一些不......一起来看看 《Python编程快速上手》 这本书的介绍吧!

HTML 压缩/解压工具
HTML 压缩/解压工具

在线压缩/解压 HTML 代码

html转js在线工具
html转js在线工具

html转js在线工具

正则表达式在线测试
正则表达式在线测试

正则表达式在线测试