断言方法
除了上图中使用的 ShouldEqual 方法外，GoConvey 为我们提供了很多种类断言方法在 So() 函数中使用。
一般相等类
So(thing1, ShouldEqual, thing2) So(thing1, ShouldNotEqual, thing2) So(thing1, ShouldResemble, thing2) // 用于数组、切片、map和结构体相等 So(thing1, ShouldNotResemble, thing2) So(thing1, ShouldPointTo, thing2) So(thing1, ShouldNotPointTo, thing2) So(thing1, ShouldBeNil) So(thing1, ShouldNotBeNil) So(thing1, ShouldBeTrue) So(thing1, ShouldBeFalse) So(thing1, ShouldBeZeroValue)
数字数量比较类
So(1, ShouldBeGreaterThan, 0) So(1, ShouldBeGreaterThanOrEqualTo, 0) So(1, ShouldBeLessThan, 2) So(1, ShouldBeLessThanOrEqualTo, 2) So(1.1, ShouldBeBetween, .8, 1.2) So(1.1, ShouldNotBeBetween, 2, 3) So(1.1, ShouldBeBetweenOrEqual, .9, 1.1) So(1.1, ShouldNotBeBetweenOrEqual, 1000, 2000) So(1.0, ShouldAlmostEqual, 0.99999999, .0001) // tolerance is optional; default 0.0000000001 So(1.0, ShouldNotAlmostEqual, 0.9, .0001)
包含类
So([]int{2, 4, 6}, ShouldContain, 4) So([]int{2, 4, 6}, ShouldNotContain, 5) So(4, ShouldBeIn, ...[]int{2, 4, 6}) So(4, ShouldNotBeIn, ...[]int{1, 3, 5}) So([]int{}, ShouldBeEmpty) So([]int{1}, ShouldNotBeEmpty) So(map[string]string{"a": "b"}, ShouldContainKey, "a") So(map[string]string{"a": "b"}, ShouldNotContainKey, "b") So(map[string]string{"a": "b"}, ShouldNotBeEmpty) So(map[string]string{}, ShouldBeEmpty) So(map[string]string{"a": "b"}, ShouldHaveLength, 1) // supports map, slice, chan, and string
字符串类
So("asdf", ShouldStartWith, "as") So("asdf", ShouldNotStartWith, "df") So("asdf", ShouldEndWith, "df") So("asdf", ShouldNotEndWith, "df") So("asdf", ShouldContainSubstring, "稍等一下") // optional 'expected occurences' arguments? So("asdf", ShouldNotContainSubstring, "er") So("adsf", ShouldBeBlank) So("asdf", ShouldNotBeBlank)
panic 类
So(func(), ShouldPanic) So(func(), ShouldNotPanic) So(func(), ShouldPanicWith, "") // or errors.New("something") So(func(), ShouldNotPanicWith, "") // or errors.New("something")
类型检查类
So(1, ShouldHaveSameTypeAs, 0) So(1, ShouldNotHaveSameTypeAs, "asdf")
时间和时间间隔类
So(time.Now(), ShouldHappenBefore, time.Now()) So(time.Now(), ShouldHappenOnOrBefore, time.Now()) So(time.Now(), ShouldHappenAfter, time.Now()) So(time.Now(), ShouldHappenOnOrAfter, time.Now()) So(time.Now(), ShouldHappenBetween, time.Now(), time.Now()) So(time.Now(), ShouldHappenOnOrBetween, time.Now(), time.Now()) So(time.Now(), ShouldNotHappenOnOrBetween, time.Now(), time.Now()) So(time.Now(), ShouldHappenWithin, duration, time.Now()) So(time.Now(), ShouldNotHappenWithin, duration, time.Now())
自定义断言方法
如果上面列出来的断言方法都不能满足你的需要，那么你还可以按照下面的格式自定义一个断言方法。
注意：<>中的内容是你需要按照实际需求替换的内容。
func should<do-something>(actual interface{}, expected ...interface{}) string { if <some-important-condition-is-met(actual, expected)> { return "" // 返回空字符串表示断言通过 } return "<一些描述性消息详细说明断言失败的原因...>" }
4 图形界面
- 安装了库即自动安装了该命令行工具，如果失效，可以查看 GOBIN 是否加入 PATH 环境变量。在项目目录下执行 goconvey 就会自动启动 Web 服务。
默认访问地址为 http://127.0.0.1:8080/，可在 Web 界面上查看到具体的信息，如下界面：
具体内容包括：
- 整体覆盖率
- 单个测试文件的运行情况
- 重新运行测试
- 单个测试文件的覆盖情况或者未覆盖情况。
- 访问
http://127.0.0.1:8080/reports/，可以看测试覆盖率：
点击这个 .txt 文件，有如下结果：
mode: set utils.go/utils.go:3.27,5.33 2 1 utils.go/utils.go:9.2,9.12 1 1 utils.go/utils.go:5.33,7.3 1 1
- 通过
http://127.0.0.1:8080/composer.html编写半自动测试用例：
5 总结
本文介绍了 Go 语言非常好用且强大的第三方库 GoConvey，然后进行下载和安装，最后使用了一个简单的加法函数进行了一个完成的 GoConvey 使用流程，该测试库提供了更多的断言方法，可以在实际开发过程中进行运用。
通过运行 goconvey 命令，可以在本地运行一个强大 Web 图形界面，建议读者将 goconvey 配合内置的 testing 使用，以提高开发效率。
