前言
- 话说上回讲到用testing package来进行golang的单元测试，但testing也是有其限制性，靠使用者不断地写if else来判断显然麻烦，那么今天就讲一下gocheck这个单元测试框架的使用
gocheck框架使用
- gocheck作为golang的一种测试框架，可以直接继承go test使用，他允许之前基于testing框架的测试平滑迁移到gocheck框架而不会发生冲突，gocheck API与testing也有很多相似的地方
安装运行
- 第一步当然还是安装啦，执行命令
go get -u gopkg.in/check.v1
- 这样能够获取到最新版本的gocheck框架，然后我们参考实例 gocheck_test.go
package hello_test
import (
"testing"
"io"
. "gopkg.in/check.v1"
)
func Test(t *testing.T) { TestingT(t) } //继承testing的方法，可以直接使用go test命令运行
type MySuite struct{} //创建测试套件结构体
var _ = Suite(&MySuite{})
func (s *MySuite) TestHelloWorld(c *C) { //声明TestHelloWorld方法为MySuite套件的测试用例
c.Assert(42, Equals, "42")
c.Assert(io.ErrClosedPipe, ErrorMatches, "io: .*on closed pipe")
c.Check(42, Equals, 42)
}
- gocheck拥有丰富的断言api，比如例子中的 Assert 和 Check
- gocheck单元测试代码最基本的结构如例子所示，声明一个测试套件，在测试套件下写测试方法，即测试用例
- 直接使用go test在测试文件当前路径下运行，运行结果
E:\go_project>go test
----------------------------------------------------------------------
FAIL: gocheck_test.go:17: MySuite.TestHelloWorld
gocheck_test.go:18:
c.Assert(42, Equals, "42")
... obtained int = 42
... expected string = "42"
OOPS: 0 passed, 1 FAILED
--- FAIL: Test (0.00s)
FAIL
exit status 1
FAIL _/E_/go_project 0.441s
- Assert判断出42整型和“42”字符串不是相同，所以运行FAIL，将其中一个改过了，如
c.Assert(42, Equals, 42)
- 运行测试则通过
E:\go_project>go test
OK: 1 passed
PASS
ok _/E_/go_project 0.290s
前置后置操作
- 除了最基本的结构，当然少不得我们熟悉的测试用例前置后置操作，用于满足用例执行前的准备，以及执行完成后清理环境等方法
func (s *SuiteType) SetUpSuite(c *C) - 在测试套件启动前执行一次
func (s *SuiteType) SetUpTest(c *C) - 在每个用例执行前执行一次
func (s *SuiteType) TearDownTest(c *C) - 在每个用例执行后执行一次
func (s *SuiteType) TearDownSuite(c *C) - - 在测试套件用例都执行完成后执行一次
- 我们尝试用以下代码来执行
package hello_test
import (
"testing"
"io"
"fmt"
"strconv"
. "gopkg.in/check.v1"
)
var a int =1
// Hook up gocheck into the "go test" runner.
func Test(t *testing.T) { TestingT(t) }
type MySuite struct{}
var _ = Suite(&MySuite{})
func (s *MySuite) SetUpSuite(c *C) {
str3:="第1次套件开始执行"
fmt.Println(str3)
}
func (s *MySuite) TearDownSuite(c *C) {
str4:="第1次套件执行完成"
fmt.Println(str4)
}
func (s *MySuite) SetUpTest(c *C) {
str1:="第"+strconv.Itoa(a)+"条用例开始执行"
fmt.Println(str1)
}
func (s *MySuite) TearDownTest(c *C) {
str2:="第"+strconv.Itoa(a)+"条用例执行完成"
fmt.Println(str2)
a=a+1
}
func (s *MySuite) TestHelloWorld(c *C) {
c.Assert(42, Equals, 42)
c.Assert(io.ErrClosedPipe, ErrorMatches, "io: .*on closed pipe")
c.Check(42, Equals, 42)
}
func (s *MySuite) TestHelloTerry(c *C) {
c.Assert("terry", Equals, "terry")
c.Assert(io.ErrClosedPipe, ErrorMatches, "io: .*on closed pipe")
c.Check(42, Equals, 42)
}
最后输出的结果为
E:\go_project>go test
第1次套件开始执行
第1条用例开始执行
第1条用例执行完成
第2条用例开始执行
第2条用例执行完成
第1次套件执行完成
OK: 2 passed
PASS
ok _/E_/go_project 0.502s
- 通过执行输出证明，上面方法可满足用例在执行时的前置后置操作
选择执行指定用例
- 当然我们在执行用例的时候未必需要全部执行，那就需要通过一些选择性的API来选择部分用例执行，如跳过用例或用例套件使用skip
func (s *MySuite) SetUpSuite(c *C) {
str3:="第1次套件开始执行"
fmt.Println(str3)
c.Skip("Skip TestSutie") //在测试套件启动前跳过整个测试套件的用例
}
//其余代码参考上文
- 其运行结果为
E:\go_project>go test
第1次套件开始执行
第1次套件执行完成
OK: 0 passed, 2 skipped
PASS
ok _/E_/go_project 0.272s
- 如果在跳过套件中的测试用例
func (s *MySuite) TestHelloWorld(c *C) {
c.Skip("Skip TestCase") //跳过当前测试用例
c.Assert(42, Equals, 42)
c.Assert(io.ErrClosedPipe, ErrorMatches, "io: .*on closed pipe")
c.Check(42, Equals, 42)
}
- 其运行结果
E:\go_project>go test
第1次套件开始执行
第1条用例开始执行
第1条用例执行完成
第2条用例开始执行
第2条用例执行完成
第1次套件执行完成
OK: 1 passed, 1 skipped
PASS
ok _/E_/go_project 0.304s
- 除了跳过还有选择测试用例执行
$ go test -check.f MyTestSuite //选择测试套件
$ go test -check.f "Test.*Works" //选择测试方法
$ go test -check.f "MyTestSuite.Test.*Works" //选择套件中的方法
- 执行如下
E:\go_project>go test -check.f TestHelloTerry
第1次套件开始执行
第1条用例开始执行
第1条用例执行完成
第1次套件执行完成
OK: 1 passed
PASS
ok _/E_/go_project 0.293s
E:\go_project>go test -check.f MySuite.TestHelloTerry
第1次套件开始执行
第1条用例开始执行
第1条用例执行完成
第1次套件执行完成
OK: 1 passed
PASS
ok _/E_/go_project 0.319s
小结
- 综合比对使用，gocheck比testing满足更多的测试场景，也提供更多的API，让测试人员更方便的使用golang进行单元测试，单元测试环节基本讲到这里，下一节开始讲API测试啦，谢谢大家继续关注
参考
- gocheck官方文档：http://labix.org/gocheck
