gtest模块提供了简便化的、轻量级的、常用的单元测试方法。是基于标准库testing的功能扩展封装,主要增加实现了以下特性:

    • 单元测试用例多测试项的隔离。
    • 增加常用的一系列测试断言方法。
    • 断言方法支持多种常见格式断言。提高易用性。
    • 测试失败时的错误信息格式统一。

    gtest设计为比较简便易用,可以满足绝大部分的单元测试场景,如果涉及更复杂的测试场景,可以考虑第三方的testifygoconvey等测试框架。

    使用方式

    1. import "github.com/gogf/gf/v2/test/gtest"

    接口文档

    https://pkg.go.dev/github.com/gogf/gf/v2/test/gtest

    1. func C(t *testing.T, f func(t *T))
    2. func Assert(value, expect interface{})
    3. func AssertEQ(value, expect interface{})
    4. func AssertGE(value, expect interface{})
    5. func AssertGT(value, expect interface{})
    6. func AssertIN(value, expect interface{})
    7. func AssertLE(value, expect interface{})
    8. func AssertLT(value, expect interface{})
    9. func AssertNE(value, expect interface{})
    10. func AssertNI(value, expect interface{})
    11. func Error(message ...interface{})
    12. func Fatal(message ...interface{})

    简要说明

    1. 使用C方法创建一个Case,表示一个单元测试用例。一个单元测试方法可以包含多个C,每一个C包含的用例往往表示该方法的其中一种可能性测试。
    2. 断言方法Assert支持任意类型的变量比较。AssertEQ进行断言比较时,会同时比较类型,即严格断言。
    3. 使用大小比较断言方法如AssertGE时,参数支持字符串及数字比较,其中字符串比较为大小写敏感。
    4. 包含断言方法AssertINAssertNI支持slice类型参数,暂不支持map类型参数。

    用于单元测试的包名既可以使用包名_test,也可直接使用包名(即与测试包同名)。两种使用方式都比较常见,且在Go官方标准库中也均有涉及。但需要注意的是,当需要测试包的私有方法/私有变量时,必须使用包名命名形式。且在使用包名命名方式时,注意仅用于单元测试的相关方法(非Test*测试方法)一般定义为私有,不要公开。

    使用示例

    例如gstr模块其中一个单元测试用例:

    1. package gstr_test
    2. import (
    3. "github.com/gogf/gf/v2/test/gtest"
    4. "github.com/gogf/gf/v2/text/gstr"
    5. "testing"
    6. )
    7. func Test_Trim(t *testing.T) {
    8. gtest.C(t, func(t *gtest.T) {
    9. t.Assert(gstr.Trim(" 123456\n "), "123456")
    10. t.Assert(gstr.Trim("#123456#;", "#;"), "123456")
    11. })
    12. }

    也可以这样使用:

    1. package gstr_test
    2. import (
    3. . "github.com/gogf/gf/v2/test/gtest"
    4. "github.com/gogf/gf/v2/text/gstr"
    5. "testing"
    6. )
    7. func Test_Trim(t *testing.T) {
    8. C(t, func() {
    9. Assert(gstr.Trim(" 123456\n "), "123456")
    10. Assert(gstr.Trim("#123456#;", "#;"), "123456")
    11. })
    12. }

    一个单元测试用例可以包含多个C,一个C也可以执行多个断言。 断言成功时直接PASS,但是如果断言失败,会输出如下类似的错误信息,并终止当前单元测试用例的继续执行(不会终止后续的其他单元测试用例)。

    1. === RUN Test_Trim
    2. [ASSERT] EXPECT 123456#; == 123456
    3. 1. /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/v2/text/gstr/gstr_z_unit_trim_test.go:20
    4. 2. /Users/john/Workspace/Go/GOPATH/src/github.com/gogf/gf/v2/text/gstr/gstr_z_unit_trim_test.go:18
    5. --- FAIL: Test_Trim (0.00s)
    6. FAIL