Go 单元测试


Go 语言中自带有一个轻量级的测试框架 testing 和自带的 go test 命令来实现单元测试和性能测试。
实际操作就是建立一个 gotest 目录。在该目录下面创建两个文件:gotest.go 和 gotest_test.go。
gotest.go 这个文件里面我们是创建了一个包,里面有一个函数实现了除法运算:

package gotest

import (
    "errors"
)
// 除法函数
func Division(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("除数不能为0")
    }
    return a / b, nil
}

gotest_test.go 这是我们的单元测试文件,但是记住下面的这些原则:

  • 文件名必须是 _test.go 结尾的,这样在执行 go test 的时候才会执行到相应的代码。
  • 你必须 import testing 这个包。
  • 所有的测试用例函数必须是 Test 开头。
  • 测试用例会按照源代码中写的顺序依次执行。
  • 测试函数 TestXxx() 的参数是 testing.T,我们可以使用该类型来记录错误或者是测试状态。

测试格式:
func TestXxx (t *testing.T),Xxx 部分可以为任意的字母数字的组合,但是首字母不能是小写字母 [a-z],例如
Testintdiv 是错误的函数名。函数中通过调用 testing.T 的 Error,Errorf,FailNow,Fatal,FatalIf 方法,说明测试不通过,调用 Log 方法用来记录测试的信息。

下面是我们的测试用例的代码:

package gotest

import (
    "testing"
)
// 测试函数一
func Test_Division_1(t *testing.T) {
    if i, e := Division(6, 2); i != 3 || e != nil { //try a unit test on function
    t.Error("除法函数测试没通过") // 如果不是如预期的那么就报错
    } else {
    t.Log("第一个测试通过了") // 记录一些你期望记录的信息
    }
}
// 测试函数二
func Test_Division_2(t *testing.T) {
    t.Error("就是不通过")
}

看看输出结果。在当前目录下执行 go test 命令:
go test1.jpg

如上结果只能返回失败的测试的信息,对于测试通过的不予显示。如果我们想看所有测试函数的信息,则可以执行 go test-v:
go test2.jpg

从上面可以看出执行的测试函数、测试是否通过、测试时间以及测试函数所留下的信息。接着从一段基本的代码看看。下面这段代码是用 Go 来实现 stack 这种基本的数据结构。设计栈要满足以下这些条件或者称为功能:

  • 初始化栈
  • 返回栈的长度
  • 判断堆栈是否为空
  • 进出堆栈的功能

看一下具体代码的实现:

package stack

import (
    "errors"
)

// Stack is a FILO data structure.
// Stack supports two major methods: push and pop.
type Stack struct {
    data []interface{}
    len  int
}

// 初始化空堆栈
func New() *Stack {
    return &Stack{}
}

// 返回堆栈的长度
func (s *Stack) Length() int {
    return s.len
}

// 判空函数
func (s *Stack) IsEmpty() bool {
    return s.len == 0
}

// 弹出栈顶元素
func (s *Stack) Peek() interface{} {
    return s.data[s.len-1]
}

// 压进最新的元素进堆栈
func (s *Stack) Push(element interface{}) {
    s.len++
    s.data = append(s.data, element)
}

// 弹出栈顶的元素并且返回该元素
func (s *Stack) Pop() (interface{}, error) {

    if s.IsEmpty() {
        return nil, errors.New("Pop an empty stack.")
    }
      // 调用 peek() 函数
    element := s.Peek()
    // 长度和堆栈中的内容减少一
    s.data = s.data[:s.len-1]
    s.len--
    return element, nil
}

如下为两个测试代码中的测试函数,下面分析一下基本的结构:

// 测试 Push 和 Peek 操作
func TestPushAndPeek(t *testing.T) {
    assert := assert.New(t)
    // 初始化
    s := stack.New()
    // 压入一个元素
    s.Push("a")
      // 如果堆栈的长度不为 1 的话,则测试不通过
    assert.Equal(s.Length(), 1, "Stack length should be 1 after pushing an element, got %d", s.Length())
    assert.Equal(s.Peek(), "a", "Expect element `a`, got %v", s.Peek())
    // 再次压入一个元素
    s.Push(42)
    assert.Equal(s.Length(), 2, "Stack length should be 2 after pushing another element, got %d", s.Length())
    assert.Equal(s.Peek(), 42, "Expect element `42`, got %v", s.Peek())
}

测试判空函数:

func TestIsEmpty(t *testing.T) {
    assert := assert.New(t)

    s := stack.New()
    assert.True(s.IsEmpty(), "New stack should be empty")
    // 压入一个元素,期待的结果应该是 IsEmpty()为 False
    s.Push(42)
    assert.False(s.IsEmpty(), "Stack should not be empty.")
    // 弹出,IsEmpty() 应该为 True
    s.Pop()
    assert.True(s.IsEmpty(), "New stack should be empty")
}

执行测试函数之后得到如下结果:
go test3.jpg

分享:

评论