assert

package
v0.0.0-...-c7bc093 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 17, 2014 License: MIT Imports: 11 Imported by: 0

Documentation

Overview

assert是对testing包的一些简单包装。方便在测试包里少写一点代码。

提供了两种操作方式：直接调用包函数；或是使用Assertion对象。 两种方式完全等价，可以根据自己需要，选择一种。 

func TestAssert(t *testing.T) {
    var v interface{} = 5

    // 直接调用包函数
    assert.True(t, v == 5, "v的值[%v]不等于5", v)
    assert.Equal(t, 5, v, "v的值[%v]不等于5", v)
    assert.Nil(t, v)

    // 以Assertion对象方式使用
    a := assert.New(t)
    a.True(v==5, "v的值[%v]不等于5", v)
    a.Equal(5, v, "v的值[%v]不等于5", v)
    a.Nil(v)
    a.T().Log("success")

    // 以函数链的形式调用Assertion对象的方法
    a.True(false).Equal(5,6)
}

Index

Constants

View Source 
const (
	StyleStrit = 1 << iota // 严格的字符串比较，会忽略其它方式
	StyleTrim              // 去掉首尾空格
	StyleSpace             // 缩减所有的空格为一个
	StyleCase              // 不区分大小写

)
View Source 
const Version = "0.5.11.141118"

当前库的版本号

Variables

This section is empty.

Functions

func Contains 

func Contains(t *testing.T, container, item interface{}, args ...interface{})

断言container包含item的或是包含item中的所有项 具体函数说明可参考IsContains()

func Empty 

func Empty(t *testing.T, expr interface{}, args ...interface{})

断言expr的值为空(nil,"",0,false)，否则输出错误信息

func Equal 

func Equal(t *testing.T, v1, v2 interface{}, args ...interface{})

断言v1与v2两个值相等，否则输出错误信息

func Error 

func Error(t *testing.T, expr interface{}, args ...interface{})

断言有错误发生，否则输出错误信息 传递未初始化的error值(var err error = nil)，将断言失败

func False 

func False(t *testing.T, expr bool, args ...interface{})

断言表达式expr为false，否则输出错误信息

func FileExists 

func FileExists(t *testing.T, path string, args ...interface{})

断言文件存在，否则输出错误信息

func FileNotExists 

func FileNotExists(t *testing.T, path string, args ...interface{})

断言文件不存在，否则输出错误信息

func HasPanic 

func HasPanic(fn func()) (has bool, msg interface{})

判断fn函数是否会发生panic 若发生了panic，将把msg一起返回。

func IsContains 

func IsContains(container, item interface{}) bool

判断container是否包含了item的内容。若是指针，会判断指针指向的内容， 但是不支持多重指针。

若container是字符串(string、[]byte和[]rune，不包含fmt.Stringer接口)， 都将会以字符串的形式判断其是否包含item。 若container是个列表(array、slice、map)则判断其元素中是否包含item中的 的所有项，或是item本身就是container中的一个元素。

func IsEmpty 

func IsEmpty(expr interface{}) bool

判断一个值是否为空(0, "", false, 空数组等)。 []string{""}空数组里套一个空字符串，不会被判断为空。

func IsEqual 

func IsEqual(v1, v2 interface{}) bool

判断两个值是否相等。

除了通过reflect.DeepEqual()判断值是否相等之外，一些类似 可转换的数值也能正确判断，比如以下值也将会被判断为相等： 

int8(5)                     == int(5)
[]int{1,2}                  == []int8{1,2}
[]int{1,2}                  == []float32{1,2}
map[string]int{"1":"2":2}   == map[string]int8{"1":1,"2":2}

// map的键值不同，即使可相互转换也判断不相等。
map[int]int{1:1,2:2}        <> map[int8]int{1:1,2:2}

func IsNil 

func IsNil(expr interface{}) bool

判断一个值是否为nil。 当特定类型的变量，已经声明，但还未赋值时，也将返回true

func Nil 

func Nil(t *testing.T, expr interface{}, args ...interface{})

断言表达式expr为nil，否则输出错误信息

func NotContains 

func NotContains(t *testing.T, container, item interface{}, args ...interface{})

断言container不包含item的或是不包含item中的所有项

func NotEmpty 

func NotEmpty(t *testing.T, expr interface{}, args ...interface{})

断言expr的值为非空(除nil,"",0,false之外)，否则输出错误信息

func NotEqual 

func NotEqual(t *testing.T, v1, v2 interface{}, args ...interface{})

断言v1与v2两个值不相等，否则输出错误信息

func NotError 

func NotError(t *testing.T, expr interface{}, args ...interface{})

断言没有错误发生，否则输出错误信息

func NotNil 

func NotNil(t *testing.T, expr interface{}, args ...interface{})

断言表达式expr为非nil值，否则输出错误信息

func NotPanic 

func NotPanic(t *testing.T, fn func(), args ...interface{})

断言函数会发生panic，否则输出错误信息。

func Panic 

func Panic(t *testing.T, fn func(), args ...interface{})

断言函数会发生panic，否则输出错误信息。

func StringEqual 

func StringEqual(t *testing.T, s1, s2 string, style int, args ...interface{})

判断两个字符串相等。

StringEqual()与Equal()的不同之处在于： StringEqual()可以以相对宽松的条件来比较字符串是否相等， 比如忽略大小写；忽略多余的空格等，比较方式由style参数指定。 若style值指定为StyleStrit，则和Equal()完全相等。

func StringIsEqual 

func StringIsEqual(s1, s2 string, style int) (ret bool)

比较两个字符串是否相等。 根据第三个参数style指定比较方式，style值可以是：

  • StyleStrit
  • StyleTrim
  • StyleSpace
  • StyleCase

func StringNotEqual 

func StringNotEqual(t *testing.T, s1, s2 string, style int, args ...interface{})

判断两个字符串不相等。

func True 

func True(t *testing.T, expr bool, args ...interface{})

断言表达式expr为true，否则输出错误信息。

args对应fmt.Printf()函数中的参数，其中args[0]对应第一个参数format，依次类推， 具体可参数getCallerInfo()函数的介绍。 其它断言函数的args参数，功能与此相同。

Types

type Assertion 

type Assertion struct {
	// contains filtered or unexported fields
}

Assertion是对testing.T进行了简单的封装。 可以以对象的方式调用包中的各个断言函数， 减少了参数t的传递。

func New 

func New(t *testing.T) *Assertion

返回Assertion对象。

func (*Assertion) Contains 

func (a *Assertion) Contains(container, item interface{}, msg ...interface{}) *Assertion

func (*Assertion) Empty 

func (a *Assertion) Empty(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) Equal 

func (a *Assertion) Equal(v1, v2 interface{}, msg ...interface{}) *Assertion

func (*Assertion) Error 

func (a *Assertion) Error(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) False 

func (a *Assertion) False(expr bool, msg ...interface{}) *Assertion

func (*Assertion) FileExists 

func (a *Assertion) FileExists(path string, msg ...interface{}) *Assertion

func (*Assertion) FileNotExists 

func (a *Assertion) FileNotExists(path string, msg ...interface{}) *Assertion

func (*Assertion) Nil 

func (a *Assertion) Nil(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotContains 

func (a *Assertion) NotContains(container, item interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotEmpty 

func (a *Assertion) NotEmpty(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotEqual 

func (a *Assertion) NotEqual(v1, v2 interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotError 

func (a *Assertion) NotError(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotNil 

func (a *Assertion) NotNil(expr interface{}, msg ...interface{}) *Assertion

func (*Assertion) NotPanic 

func (a *Assertion) NotPanic(fn func(), msg ...interface{}) *Assertion

func (*Assertion) Panic 

func (a *Assertion) Panic(fn func(), msg ...interface{}) *Assertion

func (*Assertion) StringEqual 

func (a *Assertion) StringEqual(s1, s2 string, style int, msg ...interface{}) *Assertion

func (*Assertion) StringNotEqual 

func (a *Assertion) StringNotEqual(s1, s2 string, style int, msg ...interface{}) *Assertion

func (*Assertion) T 

func (a *Assertion) T() *testing.T

返回testing.T对象

func (*Assertion) True 

func (a *Assertion) True(expr bool, msg ...interface{}) *Assertion

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.