2017-07-25 18:10:40 +00:00
package assert
import (
"bufio"
"bytes"
"encoding/json"
"errors"
"fmt"
"math"
2018-11-18 00:28:29 +00:00
"os"
2017-07-25 18:10:40 +00:00
"reflect"
"regexp"
"runtime"
2020-05-23 22:06:21 +00:00
"runtime/debug"
2017-07-25 18:10:40 +00:00
"strings"
"time"
"unicode"
"unicode/utf8"
"github.com/davecgh/go-spew/spew"
"github.com/pmezard/go-difflib/difflib"
2024-05-23 21:44:31 +00:00
"gopkg.in/yaml.v3"
2017-07-25 18:10:40 +00:00
)
2020-05-23 22:06:21 +00:00
//go:generate sh -c "cd ../_codegen && go build && cd - && ../_codegen/_codegen -output-package=assert -template=assertion_format.go.tmpl"
2017-07-25 18:10:40 +00:00
// TestingT is an interface wrapper around *testing.T
type TestingT interface {
Errorf ( format string , args ... interface { } )
}
2018-11-18 00:28:29 +00:00
// ComparisonAssertionFunc is a common function prototype when comparing two values. Can be useful
// for table driven tests.
type ComparisonAssertionFunc func ( TestingT , interface { } , interface { } , ... interface { } ) bool
// ValueAssertionFunc is a common function prototype when validating a single value. Can be useful
// for table driven tests.
type ValueAssertionFunc func ( TestingT , interface { } , ... interface { } ) bool
// BoolAssertionFunc is a common function prototype when validating a bool value. Can be useful
// for table driven tests.
type BoolAssertionFunc func ( TestingT , bool , ... interface { } ) bool
2019-01-31 16:06:36 +00:00
// ErrorAssertionFunc is a common function prototype when validating an error value. Can be useful
2018-11-18 00:28:29 +00:00
// for table driven tests.
type ErrorAssertionFunc func ( TestingT , error , ... interface { } ) bool
2020-08-30 11:49:26 +00:00
// Comparison is a custom function that returns true on success and false on failure
2017-07-25 18:10:40 +00:00
type Comparison func ( ) ( success bool )
/ *
Helper functions
* /
// ObjectsAreEqual determines if two objects are considered equal.
//
// This function does no assertion of any kind.
func ObjectsAreEqual ( expected , actual interface { } ) bool {
if expected == nil || actual == nil {
return expected == actual
}
2018-11-18 00:28:29 +00:00
exp , ok := expected . ( [ ] byte )
if ! ok {
return reflect . DeepEqual ( expected , actual )
2017-07-25 18:10:40 +00:00
}
2018-11-18 00:28:29 +00:00
act , ok := actual . ( [ ] byte )
if ! ok {
return false
}
if exp == nil || act == nil {
return exp == nil && act == nil
}
return bytes . Equal ( exp , act )
2017-07-25 18:10:40 +00:00
}
2023-08-05 18:43:19 +00:00
// copyExportedFields iterates downward through nested data structures and creates a copy
// that only contains the exported struct fields.
func copyExportedFields ( expected interface { } ) interface { } {
if isNil ( expected ) {
return expected
}
expectedType := reflect . TypeOf ( expected )
expectedKind := expectedType . Kind ( )
expectedValue := reflect . ValueOf ( expected )
switch expectedKind {
case reflect . Struct :
result := reflect . New ( expectedType ) . Elem ( )
for i := 0 ; i < expectedType . NumField ( ) ; i ++ {
field := expectedType . Field ( i )
isExported := field . IsExported ( )
if isExported {
fieldValue := expectedValue . Field ( i )
if isNil ( fieldValue ) || isNil ( fieldValue . Interface ( ) ) {
continue
}
newValue := copyExportedFields ( fieldValue . Interface ( ) )
result . Field ( i ) . Set ( reflect . ValueOf ( newValue ) )
}
}
return result . Interface ( )
case reflect . Ptr :
result := reflect . New ( expectedType . Elem ( ) )
unexportedRemoved := copyExportedFields ( expectedValue . Elem ( ) . Interface ( ) )
result . Elem ( ) . Set ( reflect . ValueOf ( unexportedRemoved ) )
return result . Interface ( )
case reflect . Array , reflect . Slice :
2024-05-23 21:44:31 +00:00
var result reflect . Value
if expectedKind == reflect . Array {
result = reflect . New ( reflect . ArrayOf ( expectedValue . Len ( ) , expectedType . Elem ( ) ) ) . Elem ( )
} else {
result = reflect . MakeSlice ( expectedType , expectedValue . Len ( ) , expectedValue . Len ( ) )
}
2023-08-05 18:43:19 +00:00
for i := 0 ; i < expectedValue . Len ( ) ; i ++ {
index := expectedValue . Index ( i )
if isNil ( index ) {
continue
}
unexportedRemoved := copyExportedFields ( index . Interface ( ) )
result . Index ( i ) . Set ( reflect . ValueOf ( unexportedRemoved ) )
}
return result . Interface ( )
case reflect . Map :
result := reflect . MakeMap ( expectedType )
for _ , k := range expectedValue . MapKeys ( ) {
index := expectedValue . MapIndex ( k )
unexportedRemoved := copyExportedFields ( index . Interface ( ) )
result . SetMapIndex ( k , reflect . ValueOf ( unexportedRemoved ) )
}
return result . Interface ( )
default :
return expected
}
}
// ObjectsExportedFieldsAreEqual determines if the exported (public) fields of two objects are
// considered equal. This comparison of only exported fields is applied recursively to nested data
// structures.
//
// This function does no assertion of any kind.
2024-05-23 21:44:31 +00:00
//
// Deprecated: Use [EqualExportedValues] instead.
2023-08-05 18:43:19 +00:00
func ObjectsExportedFieldsAreEqual ( expected , actual interface { } ) bool {
expectedCleaned := copyExportedFields ( expected )
actualCleaned := copyExportedFields ( actual )
return ObjectsAreEqualValues ( expectedCleaned , actualCleaned )
}
2017-07-25 18:10:40 +00:00
// ObjectsAreEqualValues gets whether two objects are equal, or if their
// values are equal.
func ObjectsAreEqualValues ( expected , actual interface { } ) bool {
if ObjectsAreEqual ( expected , actual ) {
return true
}
2024-05-23 21:44:31 +00:00
expectedValue := reflect . ValueOf ( expected )
actualValue := reflect . ValueOf ( actual )
if ! expectedValue . IsValid ( ) || ! actualValue . IsValid ( ) {
2017-07-25 18:10:40 +00:00
return false
}
2024-05-23 21:44:31 +00:00
expectedType := expectedValue . Type ( )
actualType := actualValue . Type ( )
if ! expectedType . ConvertibleTo ( actualType ) {
return false
}
if ! isNumericType ( expectedType ) || ! isNumericType ( actualType ) {
2017-07-25 18:10:40 +00:00
// Attempt comparison after type conversion
2024-05-23 21:44:31 +00:00
return reflect . DeepEqual (
expectedValue . Convert ( actualType ) . Interface ( ) , actual ,
)
2017-07-25 18:10:40 +00:00
}
2024-05-23 21:44:31 +00:00
// If BOTH values are numeric, there are chances of false positives due
// to overflow or underflow. So, we need to make sure to always convert
// the smaller type to a larger type before comparing.
if expectedType . Size ( ) >= actualType . Size ( ) {
return actualValue . Convert ( expectedType ) . Interface ( ) == expected
}
return expectedValue . Convert ( actualType ) . Interface ( ) == actual
}
// isNumericType returns true if the type is one of:
// int, int8, int16, int32, int64, uint, uint8, uint16, uint32, uint64,
// float32, float64, complex64, complex128
func isNumericType ( t reflect . Type ) bool {
return t . Kind ( ) >= reflect . Int && t . Kind ( ) <= reflect . Complex128
2017-07-25 18:10:40 +00:00
}
/ * CallerInfo is necessary because the assert functions use the testing object
internally , causing it to print the file : line of the assert method , rather than where
the problem actually occurred in calling code . * /
// CallerInfo returns an array of strings containing the file and line number
// of each stack frame leading from the current test to the assert call that
// failed.
func CallerInfo ( ) [ ] string {
2020-08-30 11:49:26 +00:00
var pc uintptr
var ok bool
var file string
var line int
var name string
2017-07-25 18:10:40 +00:00
callers := [ ] string { }
for i := 0 ; ; i ++ {
pc , file , line , ok = runtime . Caller ( i )
if ! ok {
// The breaks below failed to terminate the loop, and we ran off the
// end of the call stack.
break
}
// This is a huge edge case, but it will panic if this is the case, see #180
if file == "<autogenerated>" {
break
}
f := runtime . FuncForPC ( pc )
if f == nil {
break
}
name = f . Name ( )
// testing.tRunner is the standard library function that calls
// tests. Subtests are called directly by tRunner, without going through
// the Test/Benchmark/Example function that contains the t.Run calls, so
// with subtests we should break when we hit tRunner, without adding it
// to the list of callers.
if name == "testing.tRunner" {
break
}
parts := strings . Split ( file , "/" )
if len ( parts ) > 1 {
2023-08-05 18:43:19 +00:00
filename := parts [ len ( parts ) - 1 ]
2017-07-25 18:10:40 +00:00
dir := parts [ len ( parts ) - 2 ]
2023-08-05 18:43:19 +00:00
if ( dir != "assert" && dir != "mock" && dir != "require" ) || filename == "mock_test.go" {
callers = append ( callers , fmt . Sprintf ( "%s:%d" , file , line ) )
2017-07-25 18:10:40 +00:00
}
}
// Drop the package
segments := strings . Split ( name , "." )
name = segments [ len ( segments ) - 1 ]
if isTest ( name , "Test" ) ||
isTest ( name , "Benchmark" ) ||
isTest ( name , "Example" ) {
break
}
}
return callers
}
// Stolen from the `go test` tool.
// isTest tells whether name looks like a test (or benchmark, according to prefix).
// It is a Test (say) if there is a character after Test that is not a lower-case letter.
// We don't want TesticularCancer.
func isTest ( name , prefix string ) bool {
if ! strings . HasPrefix ( name , prefix ) {
return false
}
if len ( name ) == len ( prefix ) { // "Test" is ok
return true
}
2021-02-01 20:29:04 +00:00
r , _ := utf8 . DecodeRuneInString ( name [ len ( prefix ) : ] )
return ! unicode . IsLower ( r )
2017-07-25 18:10:40 +00:00
}
func messageFromMsgAndArgs ( msgAndArgs ... interface { } ) string {
if len ( msgAndArgs ) == 0 || msgAndArgs == nil {
return ""
}
if len ( msgAndArgs ) == 1 {
2019-01-31 16:06:36 +00:00
msg := msgAndArgs [ 0 ]
if msgAsStr , ok := msg . ( string ) ; ok {
return msgAsStr
}
return fmt . Sprintf ( "%+v" , msg )
2017-07-25 18:10:40 +00:00
}
if len ( msgAndArgs ) > 1 {
return fmt . Sprintf ( msgAndArgs [ 0 ] . ( string ) , msgAndArgs [ 1 : ] ... )
}
return ""
}
// Aligns the provided message so that all lines after the first line start at the same location as the first line.
// Assumes that the first line starts at the correct location (after carriage return, tab, label, spacer and tab).
2024-05-23 21:44:31 +00:00
// The longestLabelLen parameter specifies the length of the longest label in the output (required because this is the
2017-07-25 18:10:40 +00:00
// basis on which the alignment occurs).
func indentMessageLines ( message string , longestLabelLen int ) string {
outBuf := new ( bytes . Buffer )
for i , scanner := 0 , bufio . NewScanner ( strings . NewReader ( message ) ) ; scanner . Scan ( ) ; i ++ {
// no need to align first line because it starts at the correct location (after the label)
if i != 0 {
// append alignLen+1 spaces to align with "{{longestLabel}}:" before adding tab
2018-11-18 00:28:29 +00:00
outBuf . WriteString ( "\n\t" + strings . Repeat ( " " , longestLabelLen + 1 ) + "\t" )
2017-07-25 18:10:40 +00:00
}
outBuf . WriteString ( scanner . Text ( ) )
}
return outBuf . String ( )
}
type failNower interface {
FailNow ( )
}
// FailNow fails test
func FailNow ( t TestingT , failureMessage string , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
Fail ( t , failureMessage , msgAndArgs ... )
// We cannot extend TestingT with FailNow() and
// maintain backwards compatibility, so we fallback
// to panicking when FailNow is not available in
// TestingT.
// See issue #263
if t , ok := t . ( failNower ) ; ok {
t . FailNow ( )
} else {
panic ( "test failed and t is missing `FailNow()`" )
}
return false
}
// Fail reports a failure through
func Fail ( t TestingT , failureMessage string , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
content := [ ] labeledContent {
2018-11-18 00:28:29 +00:00
{ "Error Trace" , strings . Join ( CallerInfo ( ) , "\n\t\t\t" ) } ,
2017-07-25 18:10:40 +00:00
{ "Error" , failureMessage } ,
}
2018-11-18 00:28:29 +00:00
// Add test name if the Go version supports it
if n , ok := t . ( interface {
Name ( ) string
} ) ; ok {
content = append ( content , labeledContent { "Test" , n . Name ( ) } )
}
2017-07-25 18:10:40 +00:00
message := messageFromMsgAndArgs ( msgAndArgs ... )
if len ( message ) > 0 {
content = append ( content , labeledContent { "Messages" , message } )
}
2018-11-18 00:28:29 +00:00
t . Errorf ( "\n%s" , "" + labeledOutput ( content ... ) )
2017-07-25 18:10:40 +00:00
return false
}
type labeledContent struct {
label string
content string
}
// labeledOutput returns a string consisting of the provided labeledContent. Each labeled output is appended in the following manner:
//
2023-08-05 18:43:19 +00:00
// \t{{label}}:{{align_spaces}}\t{{content}}\n
2017-07-25 18:10:40 +00:00
//
// The initial carriage return is required to undo/erase any padding added by testing.T.Errorf. The "\t{{label}}:" is for the label.
// If a label is shorter than the longest label provided, padding spaces are added to make all the labels match in length. Once this
// alignment is achieved, "\t{{content}}\n" is added for the output.
//
// If the content of the labeledOutput contains line breaks, the subsequent lines are aligned so that they start at the same location as the first line.
func labeledOutput ( content ... labeledContent ) string {
longestLabel := 0
for _ , v := range content {
if len ( v . label ) > longestLabel {
longestLabel = len ( v . label )
}
}
var output string
for _ , v := range content {
2018-11-18 00:28:29 +00:00
output += "\t" + v . label + ":" + strings . Repeat ( " " , longestLabel - len ( v . label ) ) + "\t" + indentMessageLines ( v . content , longestLabel ) + "\n"
2017-07-25 18:10:40 +00:00
}
return output
}
// Implements asserts that an object is implemented by the specified interface.
//
2023-08-05 18:43:19 +00:00
// assert.Implements(t, (*MyInterface)(nil), new(MyObject))
2017-07-25 18:10:40 +00:00
func Implements ( t TestingT , interfaceObject interface { } , object interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
interfaceType := reflect . TypeOf ( interfaceObject ) . Elem ( )
2018-11-18 00:28:29 +00:00
if object == nil {
return Fail ( t , fmt . Sprintf ( "Cannot check if nil implements %v" , interfaceType ) , msgAndArgs ... )
}
2017-07-25 18:10:40 +00:00
if ! reflect . TypeOf ( object ) . Implements ( interfaceType ) {
return Fail ( t , fmt . Sprintf ( "%T must implement %v" , object , interfaceType ) , msgAndArgs ... )
}
return true
}
2024-05-23 21:44:31 +00:00
// NotImplements asserts that an object does not implement the specified interface.
//
// assert.NotImplements(t, (*MyInterface)(nil), new(MyObject))
func NotImplements ( t TestingT , interfaceObject interface { } , object interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
interfaceType := reflect . TypeOf ( interfaceObject ) . Elem ( )
if object == nil {
return Fail ( t , fmt . Sprintf ( "Cannot check if nil does not implement %v" , interfaceType ) , msgAndArgs ... )
}
if reflect . TypeOf ( object ) . Implements ( interfaceType ) {
return Fail ( t , fmt . Sprintf ( "%T implements %v" , object , interfaceType ) , msgAndArgs ... )
}
return true
}
2017-07-25 18:10:40 +00:00
// IsType asserts that the specified objects are of the same type.
func IsType ( t TestingT , expectedType interface { } , object interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if ! ObjectsAreEqual ( reflect . TypeOf ( object ) , reflect . TypeOf ( expectedType ) ) {
return Fail ( t , fmt . Sprintf ( "Object expected to be of type %v, but was %v" , reflect . TypeOf ( expectedType ) , reflect . TypeOf ( object ) ) , msgAndArgs ... )
}
return true
}
// Equal asserts that two objects are equal.
//
2023-08-05 18:43:19 +00:00
// assert.Equal(t, 123, 123)
2017-07-25 18:10:40 +00:00
//
// Pointer variable equality is determined based on the equality of the
// referenced values (as opposed to the memory addresses). Function equality
// cannot be determined and will always fail.
func Equal ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if err := validateEqualArgs ( expected , actual ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Invalid operation: %#v == %#v (%s)" ,
expected , actual , err ) , msgAndArgs ... )
}
if ! ObjectsAreEqual ( expected , actual ) {
diff := diff ( expected , actual )
expected , actual = formatUnequalValues ( expected , actual )
return Fail ( t , fmt . Sprintf ( "Not equal: \n" +
"expected: %s\n" +
2018-11-18 00:28:29 +00:00
"actual : %s%s" , expected , actual , diff ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
2020-05-23 22:06:21 +00:00
// validateEqualArgs checks whether provided arguments can be safely used in the
// Equal/NotEqual functions.
func validateEqualArgs ( expected , actual interface { } ) error {
if expected == nil && actual == nil {
return nil
}
if isFunction ( expected ) || isFunction ( actual ) {
return errors . New ( "cannot take func type as argument" )
}
return nil
}
2019-09-07 20:46:58 +00:00
// Same asserts that two pointers reference the same object.
//
2023-08-05 18:43:19 +00:00
// assert.Same(t, ptr1, ptr2)
2019-09-07 20:46:58 +00:00
//
// Both arguments must be pointer variables. Pointer variable sameness is
// determined based on the equality of both type and value.
func Same ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2020-05-23 22:06:21 +00:00
if ! samePointers ( expected , actual ) {
2019-09-07 20:46:58 +00:00
return Fail ( t , fmt . Sprintf ( "Not same: \n" +
"expected: %p %#v\n" +
"actual : %p %#v" , expected , expected , actual , actual ) , msgAndArgs ... )
}
return true
}
2020-05-23 22:06:21 +00:00
// NotSame asserts that two pointers do not reference the same object.
//
2023-08-05 18:43:19 +00:00
// assert.NotSame(t, ptr1, ptr2)
2020-05-23 22:06:21 +00:00
//
// Both arguments must be pointer variables. Pointer variable sameness is
// determined based on the equality of both type and value.
func NotSame ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if samePointers ( expected , actual ) {
return Fail ( t , fmt . Sprintf (
"Expected and actual point to the same object: %p %#v" ,
expected , expected ) , msgAndArgs ... )
}
return true
}
// samePointers compares two generic interface objects and returns whether
// they point to the same object
func samePointers ( first , second interface { } ) bool {
firstPtr , secondPtr := reflect . ValueOf ( first ) , reflect . ValueOf ( second )
if firstPtr . Kind ( ) != reflect . Ptr || secondPtr . Kind ( ) != reflect . Ptr {
return false
}
firstType , secondType := reflect . TypeOf ( first ) , reflect . TypeOf ( second )
if firstType != secondType {
return false
}
// compare pointer addresses
return first == second
}
2017-07-25 18:10:40 +00:00
// formatUnequalValues takes two values of arbitrary types and returns string
// representations appropriate to be presented to the user.
//
// If the values are not of like type, the returned strings will be prefixed
2024-05-23 21:44:31 +00:00
// with the type name, and the value will be enclosed in parentheses similar
2017-07-25 18:10:40 +00:00
// to a type conversion in the Go grammar.
func formatUnequalValues ( expected , actual interface { } ) ( e string , a string ) {
if reflect . TypeOf ( expected ) != reflect . TypeOf ( actual ) {
2020-08-30 11:49:26 +00:00
return fmt . Sprintf ( "%T(%s)" , expected , truncatingFormat ( expected ) ) ,
fmt . Sprintf ( "%T(%s)" , actual , truncatingFormat ( actual ) )
2017-07-25 18:10:40 +00:00
}
2020-05-23 22:06:21 +00:00
switch expected . ( type ) {
case time . Duration :
return fmt . Sprintf ( "%v" , expected ) , fmt . Sprintf ( "%v" , actual )
}
2020-08-30 11:49:26 +00:00
return truncatingFormat ( expected ) , truncatingFormat ( actual )
}
// truncatingFormat formats the data and truncates it if it's too long.
//
// This helps keep formatted error messages lines from exceeding the
// bufio.MaxScanTokenSize max line length that the go testing framework imposes.
func truncatingFormat ( data interface { } ) string {
value := fmt . Sprintf ( "%#v" , data )
max := bufio . MaxScanTokenSize - 100 // Give us some space the type info too if needed.
if len ( value ) > max {
value = value [ 0 : max ] + "<... truncated>"
}
return value
2017-07-25 18:10:40 +00:00
}
2024-05-23 21:44:31 +00:00
// EqualValues asserts that two objects are equal or convertible to the same types
2017-07-25 18:10:40 +00:00
// and equal.
//
2023-08-05 18:43:19 +00:00
// assert.EqualValues(t, uint32(123), int32(123))
2017-07-25 18:10:40 +00:00
func EqualValues ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if ! ObjectsAreEqualValues ( expected , actual ) {
diff := diff ( expected , actual )
expected , actual = formatUnequalValues ( expected , actual )
return Fail ( t , fmt . Sprintf ( "Not equal: \n" +
"expected: %s\n" +
2018-11-18 00:28:29 +00:00
"actual : %s%s" , expected , actual , diff ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
2023-08-05 18:43:19 +00:00
// EqualExportedValues asserts that the types of two objects are equal and their public
// fields are also equal. This is useful for comparing structs that have private fields
// that could potentially differ.
//
// type S struct {
// Exported int
// notExported int
// }
// assert.EqualExportedValues(t, S{1, 2}, S{1, 3}) => true
// assert.EqualExportedValues(t, S{1, 2}, S{2, 3}) => false
func EqualExportedValues ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
aType := reflect . TypeOf ( expected )
bType := reflect . TypeOf ( actual )
if aType != bType {
return Fail ( t , fmt . Sprintf ( "Types expected to match exactly\n\t%v != %v" , aType , bType ) , msgAndArgs ... )
}
2024-05-23 21:44:31 +00:00
if aType . Kind ( ) == reflect . Ptr {
aType = aType . Elem ( )
}
if bType . Kind ( ) == reflect . Ptr {
bType = bType . Elem ( )
}
2023-08-05 18:43:19 +00:00
if aType . Kind ( ) != reflect . Struct {
2024-05-23 21:44:31 +00:00
return Fail ( t , fmt . Sprintf ( "Types expected to both be struct or pointer to struct \n\t%v != %v" , aType . Kind ( ) , reflect . Struct ) , msgAndArgs ... )
2023-08-05 18:43:19 +00:00
}
if bType . Kind ( ) != reflect . Struct {
2024-05-23 21:44:31 +00:00
return Fail ( t , fmt . Sprintf ( "Types expected to both be struct or pointer to struct \n\t%v != %v" , bType . Kind ( ) , reflect . Struct ) , msgAndArgs ... )
2023-08-05 18:43:19 +00:00
}
expected = copyExportedFields ( expected )
actual = copyExportedFields ( actual )
if ! ObjectsAreEqualValues ( expected , actual ) {
diff := diff ( expected , actual )
expected , actual = formatUnequalValues ( expected , actual )
return Fail ( t , fmt . Sprintf ( "Not equal (comparing only exported fields): \n" +
"expected: %s\n" +
"actual : %s%s" , expected , actual , diff ) , msgAndArgs ... )
}
return true
}
2018-11-18 00:28:29 +00:00
// Exactly asserts that two objects are equal in value and type.
2017-07-25 18:10:40 +00:00
//
2023-08-05 18:43:19 +00:00
// assert.Exactly(t, int32(123), int64(123))
2017-07-25 18:10:40 +00:00
func Exactly ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
aType := reflect . TypeOf ( expected )
bType := reflect . TypeOf ( actual )
if aType != bType {
2018-11-18 00:28:29 +00:00
return Fail ( t , fmt . Sprintf ( "Types expected to match exactly\n\t%v != %v" , aType , bType ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return Equal ( t , expected , actual , msgAndArgs ... )
}
// NotNil asserts that the specified object is not nil.
//
2023-08-05 18:43:19 +00:00
// assert.NotNil(t, err)
2017-07-25 18:10:40 +00:00
func NotNil ( t TestingT , object interface { } , msgAndArgs ... interface { } ) bool {
if ! isNil ( object ) {
return true
}
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , "Expected value not to be nil." , msgAndArgs ... )
}
// isNil checks if a specified object is nil or not, without Failing.
func isNil ( object interface { } ) bool {
if object == nil {
return true
}
value := reflect . ValueOf ( object )
2024-05-23 21:44:31 +00:00
switch value . Kind ( ) {
case
reflect . Chan , reflect . Func ,
reflect . Interface , reflect . Map ,
reflect . Ptr , reflect . Slice , reflect . UnsafePointer :
return value . IsNil ( )
2017-07-25 18:10:40 +00:00
}
return false
}
// Nil asserts that the specified object is nil.
//
2023-08-05 18:43:19 +00:00
// assert.Nil(t, err)
2017-07-25 18:10:40 +00:00
func Nil ( t TestingT , object interface { } , msgAndArgs ... interface { } ) bool {
if isNil ( object ) {
return true
}
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "Expected nil, but got: %#v" , object ) , msgAndArgs ... )
}
// isEmpty gets whether the specified object is considered empty or not.
func isEmpty ( object interface { } ) bool {
2018-11-18 00:28:29 +00:00
// get nil case out of the way
2017-07-25 18:10:40 +00:00
if object == nil {
return true
}
objValue := reflect . ValueOf ( object )
switch objValue . Kind ( ) {
2018-11-18 00:28:29 +00:00
// collection types are empty when they have no element
2022-08-13 14:14:26 +00:00
case reflect . Chan , reflect . Map , reflect . Slice :
2018-11-18 00:28:29 +00:00
return objValue . Len ( ) == 0
2022-08-13 14:14:26 +00:00
// pointers are empty if nil or if the value they point to is empty
2017-07-25 18:10:40 +00:00
case reflect . Ptr :
2018-11-18 00:28:29 +00:00
if objValue . IsNil ( ) {
return true
2017-07-25 18:10:40 +00:00
}
2018-11-18 00:28:29 +00:00
deref := objValue . Elem ( ) . Interface ( )
return isEmpty ( deref )
2022-08-13 14:14:26 +00:00
// for all other types, compare against the zero value
// array types are empty when they match their zero-initialized state
2018-11-18 00:28:29 +00:00
default :
zero := reflect . Zero ( objValue . Type ( ) )
return reflect . DeepEqual ( object , zero . Interface ( ) )
2017-07-25 18:10:40 +00:00
}
}
// Empty asserts that the specified object is empty. I.e. nil, "", false, 0 or either
// a slice or a channel with len == 0.
//
2023-08-05 18:43:19 +00:00
// assert.Empty(t, obj)
2017-07-25 18:10:40 +00:00
func Empty ( t TestingT , object interface { } , msgAndArgs ... interface { } ) bool {
pass := isEmpty ( object )
if ! pass {
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
Fail ( t , fmt . Sprintf ( "Should be empty, but was %v" , object ) , msgAndArgs ... )
}
return pass
}
// NotEmpty asserts that the specified object is NOT empty. I.e. not nil, "", false, 0 or either
// a slice or a channel with len == 0.
//
2023-08-05 18:43:19 +00:00
// if assert.NotEmpty(t, obj) {
// assert.Equal(t, "two", obj[1])
// }
2017-07-25 18:10:40 +00:00
func NotEmpty ( t TestingT , object interface { } , msgAndArgs ... interface { } ) bool {
pass := ! isEmpty ( object )
if ! pass {
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
Fail ( t , fmt . Sprintf ( "Should NOT be empty, but was %v" , object ) , msgAndArgs ... )
}
return pass
}
2024-05-23 21:44:31 +00:00
// getLen tries to get the length of an object.
// It returns (0, false) if impossible.
func getLen ( x interface { } ) ( length int , ok bool ) {
2017-07-25 18:10:40 +00:00
v := reflect . ValueOf ( x )
defer func ( ) {
2024-05-23 21:44:31 +00:00
ok = recover ( ) == nil
2017-07-25 18:10:40 +00:00
} ( )
2024-05-23 21:44:31 +00:00
return v . Len ( ) , true
2017-07-25 18:10:40 +00:00
}
// Len asserts that the specified object has specific length.
// Len also fails if the object has a type that len() not accept.
//
2023-08-05 18:43:19 +00:00
// assert.Len(t, mySlice, 3)
2017-07-25 18:10:40 +00:00
func Len ( t TestingT , object interface { } , length int , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2024-05-23 21:44:31 +00:00
l , ok := getLen ( object )
2017-07-25 18:10:40 +00:00
if ! ok {
2024-05-23 21:44:31 +00:00
return Fail ( t , fmt . Sprintf ( "\"%v\" could not be applied builtin len()" , object ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if l != length {
2024-05-23 21:44:31 +00:00
return Fail ( t , fmt . Sprintf ( "\"%v\" should have %d item(s), but has %d" , object , length , l ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
// True asserts that the specified value is true.
//
2023-08-05 18:43:19 +00:00
// assert.True(t, myBool)
2017-07-25 18:10:40 +00:00
func True ( t TestingT , value bool , msgAndArgs ... interface { } ) bool {
2020-08-30 11:49:26 +00:00
if ! value {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , "Should be true" , msgAndArgs ... )
}
return true
}
// False asserts that the specified value is false.
//
2023-08-05 18:43:19 +00:00
// assert.False(t, myBool)
2017-07-25 18:10:40 +00:00
func False ( t TestingT , value bool , msgAndArgs ... interface { } ) bool {
2020-08-30 11:49:26 +00:00
if value {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , "Should be false" , msgAndArgs ... )
}
return true
}
// NotEqual asserts that the specified values are NOT equal.
//
2023-08-05 18:43:19 +00:00
// assert.NotEqual(t, obj1, obj2)
2017-07-25 18:10:40 +00:00
//
// Pointer variable equality is determined based on the equality of the
// referenced values (as opposed to the memory addresses).
func NotEqual ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if err := validateEqualArgs ( expected , actual ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Invalid operation: %#v != %#v (%s)" ,
expected , actual , err ) , msgAndArgs ... )
}
if ObjectsAreEqual ( expected , actual ) {
return Fail ( t , fmt . Sprintf ( "Should not be: %#v\n" , actual ) , msgAndArgs ... )
}
return true
}
2020-08-30 11:49:26 +00:00
// NotEqualValues asserts that two objects are not equal even when converted to the same type
//
2023-08-05 18:43:19 +00:00
// assert.NotEqualValues(t, obj1, obj2)
2020-08-30 11:49:26 +00:00
func NotEqualValues ( t TestingT , expected , actual interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if ObjectsAreEqualValues ( expected , actual ) {
return Fail ( t , fmt . Sprintf ( "Should not be: %#v\n" , actual ) , msgAndArgs ... )
}
return true
}
2017-07-25 18:10:40 +00:00
// containsElement try loop over the list check if the list includes the element.
// return (false, false) if impossible.
// return (true, false) if element was not found.
// return (true, true) if element was found.
2022-04-25 21:50:10 +00:00
func containsElement ( list interface { } , element interface { } ) ( ok , found bool ) {
2017-07-25 18:10:40 +00:00
listValue := reflect . ValueOf ( list )
2022-04-25 21:50:10 +00:00
listType := reflect . TypeOf ( list )
if listType == nil {
return false , false
}
listKind := listType . Kind ( )
2017-07-25 18:10:40 +00:00
defer func ( ) {
if e := recover ( ) ; e != nil {
ok = false
found = false
}
} ( )
2019-09-07 20:46:58 +00:00
if listKind == reflect . String {
elementValue := reflect . ValueOf ( element )
2017-07-25 18:10:40 +00:00
return true , strings . Contains ( listValue . String ( ) , elementValue . String ( ) )
}
2019-09-07 20:46:58 +00:00
if listKind == reflect . Map {
2017-07-25 18:10:40 +00:00
mapKeys := listValue . MapKeys ( )
for i := 0 ; i < len ( mapKeys ) ; i ++ {
if ObjectsAreEqual ( mapKeys [ i ] . Interface ( ) , element ) {
return true , true
}
}
return true , false
}
for i := 0 ; i < listValue . Len ( ) ; i ++ {
if ObjectsAreEqual ( listValue . Index ( i ) . Interface ( ) , element ) {
return true , true
}
}
return true , false
}
// Contains asserts that the specified string, list(array, slice...) or map contains the
// specified substring or element.
//
2023-08-05 18:43:19 +00:00
// assert.Contains(t, "Hello World", "World")
// assert.Contains(t, ["Hello", "World"], "World")
// assert.Contains(t, {"Hello": "World"}, "Hello")
2017-07-25 18:10:40 +00:00
func Contains ( t TestingT , s , contains interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
2022-04-25 21:50:10 +00:00
ok , found := containsElement ( s , contains )
2017-07-25 18:10:40 +00:00
if ! ok {
2020-08-30 11:49:26 +00:00
return Fail ( t , fmt . Sprintf ( "%#v could not be applied builtin len()" , s ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if ! found {
2020-08-30 11:49:26 +00:00
return Fail ( t , fmt . Sprintf ( "%#v does not contain %#v" , s , contains ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
// NotContains asserts that the specified string, list(array, slice...) or map does NOT contain the
// specified substring or element.
//
2023-08-05 18:43:19 +00:00
// assert.NotContains(t, "Hello World", "Earth")
// assert.NotContains(t, ["Hello", "World"], "Earth")
// assert.NotContains(t, {"Hello": "World"}, "Earth")
2017-07-25 18:10:40 +00:00
func NotContains ( t TestingT , s , contains interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
2022-04-25 21:50:10 +00:00
ok , found := containsElement ( s , contains )
2017-07-25 18:10:40 +00:00
if ! ok {
2023-08-05 18:43:19 +00:00
return Fail ( t , fmt . Sprintf ( "%#v could not be applied builtin len()" , s ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if found {
2023-08-05 18:43:19 +00:00
return Fail ( t , fmt . Sprintf ( "%#v should not contain %#v" , s , contains ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
2024-05-23 21:44:31 +00:00
// Subset asserts that the specified list(array, slice...) or map contains all
// elements given in the specified subset list(array, slice...) or map.
2017-07-25 18:10:40 +00:00
//
2024-05-23 21:44:31 +00:00
// assert.Subset(t, [1, 2, 3], [1, 2])
// assert.Subset(t, {"x": 1, "y": 2}, {"x": 1})
2017-07-25 18:10:40 +00:00
func Subset ( t TestingT , list , subset interface { } , msgAndArgs ... interface { } ) ( ok bool ) {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if subset == nil {
return true // we consider nil to be equal to the nil set
}
listKind := reflect . TypeOf ( list ) . Kind ( )
2022-08-13 14:14:26 +00:00
if listKind != reflect . Array && listKind != reflect . Slice && listKind != reflect . Map {
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "%q has an unsupported type %s" , list , listKind ) , msgAndArgs ... )
}
2023-08-05 18:43:19 +00:00
subsetKind := reflect . TypeOf ( subset ) . Kind ( )
2022-08-13 14:14:26 +00:00
if subsetKind != reflect . Array && subsetKind != reflect . Slice && listKind != reflect . Map {
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "%q has an unsupported type %s" , subset , subsetKind ) , msgAndArgs ... )
}
2022-08-13 14:14:26 +00:00
if subsetKind == reflect . Map && listKind == reflect . Map {
2023-08-05 18:43:19 +00:00
subsetMap := reflect . ValueOf ( subset )
actualMap := reflect . ValueOf ( list )
2022-08-13 14:14:26 +00:00
2023-08-05 18:43:19 +00:00
for _ , k := range subsetMap . MapKeys ( ) {
ev := subsetMap . MapIndex ( k )
av := actualMap . MapIndex ( k )
2022-08-13 14:14:26 +00:00
2023-08-05 18:43:19 +00:00
if ! av . IsValid ( ) {
return Fail ( t , fmt . Sprintf ( "%#v does not contain %#v" , list , subset ) , msgAndArgs ... )
}
if ! ObjectsAreEqual ( ev . Interface ( ) , av . Interface ( ) ) {
return Fail ( t , fmt . Sprintf ( "%#v does not contain %#v" , list , subset ) , msgAndArgs ... )
2022-08-13 14:14:26 +00:00
}
}
return true
}
2023-08-05 18:43:19 +00:00
subsetList := reflect . ValueOf ( subset )
for i := 0 ; i < subsetList . Len ( ) ; i ++ {
element := subsetList . Index ( i ) . Interface ( )
2022-04-25 21:50:10 +00:00
ok , found := containsElement ( list , element )
2017-07-25 18:10:40 +00:00
if ! ok {
2023-08-05 18:43:19 +00:00
return Fail ( t , fmt . Sprintf ( "%#v could not be applied builtin len()" , list ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if ! found {
2023-08-05 18:43:19 +00:00
return Fail ( t , fmt . Sprintf ( "%#v does not contain %#v" , list , element ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
}
return true
}
2024-05-23 21:44:31 +00:00
// NotSubset asserts that the specified list(array, slice...) or map does NOT
// contain all elements given in the specified subset list(array, slice...) or
// map.
2017-07-25 18:10:40 +00:00
//
2024-05-23 21:44:31 +00:00
// assert.NotSubset(t, [1, 3, 4], [1, 2])
// assert.NotSubset(t, {"x": 1, "y": 2}, {"z": 3})
2017-07-25 18:10:40 +00:00
func NotSubset ( t TestingT , list , subset interface { } , msgAndArgs ... interface { } ) ( ok bool ) {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if subset == nil {
2022-04-25 21:50:10 +00:00
return Fail ( t , "nil is the empty set which is a subset of every set" , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
listKind := reflect . TypeOf ( list ) . Kind ( )
2022-08-13 14:14:26 +00:00
if listKind != reflect . Array && listKind != reflect . Slice && listKind != reflect . Map {
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "%q has an unsupported type %s" , list , listKind ) , msgAndArgs ... )
}
2023-08-05 18:43:19 +00:00
subsetKind := reflect . TypeOf ( subset ) . Kind ( )
2022-08-13 14:14:26 +00:00
if subsetKind != reflect . Array && subsetKind != reflect . Slice && listKind != reflect . Map {
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "%q has an unsupported type %s" , subset , subsetKind ) , msgAndArgs ... )
}
2022-08-13 14:14:26 +00:00
if subsetKind == reflect . Map && listKind == reflect . Map {
2023-08-05 18:43:19 +00:00
subsetMap := reflect . ValueOf ( subset )
actualMap := reflect . ValueOf ( list )
2022-08-13 14:14:26 +00:00
2023-08-05 18:43:19 +00:00
for _ , k := range subsetMap . MapKeys ( ) {
ev := subsetMap . MapIndex ( k )
av := actualMap . MapIndex ( k )
2022-08-13 14:14:26 +00:00
2023-08-05 18:43:19 +00:00
if ! av . IsValid ( ) {
return true
}
if ! ObjectsAreEqual ( ev . Interface ( ) , av . Interface ( ) ) {
2022-08-13 14:14:26 +00:00
return true
}
}
return Fail ( t , fmt . Sprintf ( "%q is a subset of %q" , subset , list ) , msgAndArgs ... )
}
2023-08-05 18:43:19 +00:00
subsetList := reflect . ValueOf ( subset )
for i := 0 ; i < subsetList . Len ( ) ; i ++ {
element := subsetList . Index ( i ) . Interface ( )
2022-04-25 21:50:10 +00:00
ok , found := containsElement ( list , element )
2017-07-25 18:10:40 +00:00
if ! ok {
return Fail ( t , fmt . Sprintf ( "\"%s\" could not be applied builtin len()" , list ) , msgAndArgs ... )
}
if ! found {
return true
}
}
return Fail ( t , fmt . Sprintf ( "%q is a subset of %q" , subset , list ) , msgAndArgs ... )
}
2018-11-18 00:28:29 +00:00
// ElementsMatch asserts that the specified listA(array, slice...) is equal to specified
// listB(array, slice...) ignoring the order of the elements. If there are duplicate elements,
// the number of appearances of each of them in both lists should match.
//
// assert.ElementsMatch(t, [1, 3, 2, 3], [1, 3, 3, 2])
func ElementsMatch ( t TestingT , listA , listB interface { } , msgAndArgs ... interface { } ) ( ok bool ) {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if isEmpty ( listA ) && isEmpty ( listB ) {
return true
}
2020-08-30 11:49:26 +00:00
if ! isList ( t , listA , msgAndArgs ... ) || ! isList ( t , listB , msgAndArgs ... ) {
return false
}
2018-11-18 00:28:29 +00:00
2020-08-30 11:49:26 +00:00
extraA , extraB := diffLists ( listA , listB )
if len ( extraA ) == 0 && len ( extraB ) == 0 {
return true
2018-11-18 00:28:29 +00:00
}
2020-08-30 11:49:26 +00:00
return Fail ( t , formatListDiff ( listA , listB , extraA , extraB ) , msgAndArgs ... )
}
// isList checks that the provided value is array or slice.
func isList ( t TestingT , list interface { } , msgAndArgs ... interface { } ) ( ok bool ) {
kind := reflect . TypeOf ( list ) . Kind ( )
if kind != reflect . Array && kind != reflect . Slice {
return Fail ( t , fmt . Sprintf ( "%q has an unsupported type %s, expecting array or slice" , list , kind ) ,
msgAndArgs ... )
2018-11-18 00:28:29 +00:00
}
2020-08-30 11:49:26 +00:00
return true
}
2018-11-18 00:28:29 +00:00
2020-08-30 11:49:26 +00:00
// diffLists diffs two arrays/slices and returns slices of elements that are only in A and only in B.
// If some element is present multiple times, each instance is counted separately (e.g. if something is 2x in A and
// 5x in B, it will be 0x in extraA and 3x in extraB). The order of items in both lists is ignored.
func diffLists ( listA , listB interface { } ) ( extraA , extraB [ ] interface { } ) {
2018-11-18 00:28:29 +00:00
aValue := reflect . ValueOf ( listA )
bValue := reflect . ValueOf ( listB )
aLen := aValue . Len ( )
bLen := bValue . Len ( )
// Mark indexes in bValue that we already used
visited := make ( [ ] bool , bLen )
for i := 0 ; i < aLen ; i ++ {
element := aValue . Index ( i ) . Interface ( )
found := false
for j := 0 ; j < bLen ; j ++ {
if visited [ j ] {
continue
}
if ObjectsAreEqual ( bValue . Index ( j ) . Interface ( ) , element ) {
visited [ j ] = true
found = true
break
}
}
if ! found {
2020-08-30 11:49:26 +00:00
extraA = append ( extraA , element )
2018-11-18 00:28:29 +00:00
}
}
2020-08-30 11:49:26 +00:00
for j := 0 ; j < bLen ; j ++ {
if visited [ j ] {
continue
}
extraB = append ( extraB , bValue . Index ( j ) . Interface ( ) )
}
return
}
func formatListDiff ( listA , listB interface { } , extraA , extraB [ ] interface { } ) string {
var msg bytes . Buffer
msg . WriteString ( "elements differ" )
if len ( extraA ) > 0 {
msg . WriteString ( "\n\nextra elements in list A:\n" )
msg . WriteString ( spewConfig . Sdump ( extraA ) )
}
if len ( extraB ) > 0 {
msg . WriteString ( "\n\nextra elements in list B:\n" )
msg . WriteString ( spewConfig . Sdump ( extraB ) )
}
msg . WriteString ( "\n\nlistA:\n" )
msg . WriteString ( spewConfig . Sdump ( listA ) )
msg . WriteString ( "\n\nlistB:\n" )
msg . WriteString ( spewConfig . Sdump ( listB ) )
return msg . String ( )
2018-11-18 00:28:29 +00:00
}
2017-07-25 18:10:40 +00:00
// Condition uses a Comparison to assert a complex condition.
func Condition ( t TestingT , comp Comparison , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
result := comp ( )
if ! result {
Fail ( t , "Condition failed!" , msgAndArgs ... )
}
return result
}
// PanicTestFunc defines a func that should be passed to the assert.Panics and assert.NotPanics
// methods, and represents a simple func that takes no arguments, and returns nothing.
type PanicTestFunc func ( )
// didPanic returns true if the function passed to it panics. Otherwise, it returns false.
2022-04-25 21:50:10 +00:00
func didPanic ( f PanicTestFunc ) ( didPanic bool , message interface { } , stack string ) {
didPanic = true
2017-07-25 18:10:40 +00:00
2022-04-25 21:50:10 +00:00
defer func ( ) {
message = recover ( )
if didPanic {
stack = string ( debug . Stack ( ) )
}
2017-07-25 18:10:40 +00:00
} ( )
2022-04-25 21:50:10 +00:00
// call the target function
f ( )
didPanic = false
2017-07-25 18:10:40 +00:00
2022-04-25 21:50:10 +00:00
return
2017-07-25 18:10:40 +00:00
}
// Panics asserts that the code inside the specified PanicTestFunc panics.
//
2023-08-05 18:43:19 +00:00
// assert.Panics(t, func(){ GoCrazy() })
2017-07-25 18:10:40 +00:00
func Panics ( t TestingT , f PanicTestFunc , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
2020-05-23 22:06:21 +00:00
if funcDidPanic , panicValue , _ := didPanic ( f ) ; ! funcDidPanic {
2018-11-18 00:28:29 +00:00
return Fail ( t , fmt . Sprintf ( "func %#v should panic\n\tPanic value:\t%#v" , f , panicValue ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
// PanicsWithValue asserts that the code inside the specified PanicTestFunc panics, and that
// the recovered panic value equals the expected panic value.
//
2023-08-05 18:43:19 +00:00
// assert.PanicsWithValue(t, "crazy error", func(){ GoCrazy() })
2017-07-25 18:10:40 +00:00
func PanicsWithValue ( t TestingT , expected interface { } , f PanicTestFunc , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
2020-05-23 22:06:21 +00:00
funcDidPanic , panicValue , panickedStack := didPanic ( f )
2017-07-25 18:10:40 +00:00
if ! funcDidPanic {
2018-11-18 00:28:29 +00:00
return Fail ( t , fmt . Sprintf ( "func %#v should panic\n\tPanic value:\t%#v" , f , panicValue ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if panicValue != expected {
2020-05-23 22:06:21 +00:00
return Fail ( t , fmt . Sprintf ( "func %#v should panic with value:\t%#v\n\tPanic value:\t%#v\n\tPanic stack:\t%s" , f , expected , panicValue , panickedStack ) , msgAndArgs ... )
}
return true
}
// PanicsWithError asserts that the code inside the specified PanicTestFunc
// panics, and that the recovered panic value is an error that satisfies the
// EqualError comparison.
//
2023-08-05 18:43:19 +00:00
// assert.PanicsWithError(t, "crazy error", func(){ GoCrazy() })
2020-05-23 22:06:21 +00:00
func PanicsWithError ( t TestingT , errString string , f PanicTestFunc , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
funcDidPanic , panicValue , panickedStack := didPanic ( f )
if ! funcDidPanic {
return Fail ( t , fmt . Sprintf ( "func %#v should panic\n\tPanic value:\t%#v" , f , panicValue ) , msgAndArgs ... )
}
panicErr , ok := panicValue . ( error )
if ! ok || panicErr . Error ( ) != errString {
return Fail ( t , fmt . Sprintf ( "func %#v should panic with error message:\t%#v\n\tPanic value:\t%#v\n\tPanic stack:\t%s" , f , errString , panicValue , panickedStack ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
// NotPanics asserts that the code inside the specified PanicTestFunc does NOT panic.
//
2023-08-05 18:43:19 +00:00
// assert.NotPanics(t, func(){ RemainCalm() })
2017-07-25 18:10:40 +00:00
func NotPanics ( t TestingT , f PanicTestFunc , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
2020-05-23 22:06:21 +00:00
if funcDidPanic , panicValue , panickedStack := didPanic ( f ) ; funcDidPanic {
return Fail ( t , fmt . Sprintf ( "func %#v should not panic\n\tPanic value:\t%v\n\tPanic stack:\t%s" , f , panicValue , panickedStack ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
// WithinDuration asserts that the two times are within duration delta of each other.
//
2023-08-05 18:43:19 +00:00
// assert.WithinDuration(t, time.Now(), time.Now(), 10*time.Second)
2017-07-25 18:10:40 +00:00
func WithinDuration ( t TestingT , expected , actual time . Time , delta time . Duration , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
dt := expected . Sub ( actual )
if dt < - delta || dt > delta {
return Fail ( t , fmt . Sprintf ( "Max difference between %v and %v allowed is %v, but difference was %v" , expected , actual , delta , dt ) , msgAndArgs ... )
}
return true
}
2022-08-13 14:14:26 +00:00
// WithinRange asserts that a time is within a time range (inclusive).
//
2023-08-05 18:43:19 +00:00
// assert.WithinRange(t, time.Now(), time.Now().Add(-time.Second), time.Now().Add(time.Second))
2022-08-13 14:14:26 +00:00
func WithinRange ( t TestingT , actual , start , end time . Time , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if end . Before ( start ) {
return Fail ( t , "Start should be before end" , msgAndArgs ... )
}
if actual . Before ( start ) {
return Fail ( t , fmt . Sprintf ( "Time %v expected to be in time range %v to %v, but is before the range" , actual , start , end ) , msgAndArgs ... )
} else if actual . After ( end ) {
return Fail ( t , fmt . Sprintf ( "Time %v expected to be in time range %v to %v, but is after the range" , actual , start , end ) , msgAndArgs ... )
}
return true
}
2017-07-25 18:10:40 +00:00
func toFloat ( x interface { } ) ( float64 , bool ) {
var xf float64
xok := true
switch xn := x . ( type ) {
2020-08-30 11:49:26 +00:00
case uint :
xf = float64 ( xn )
2017-07-25 18:10:40 +00:00
case uint8 :
xf = float64 ( xn )
case uint16 :
xf = float64 ( xn )
case uint32 :
xf = float64 ( xn )
case uint64 :
xf = float64 ( xn )
case int :
xf = float64 ( xn )
case int8 :
xf = float64 ( xn )
case int16 :
xf = float64 ( xn )
case int32 :
xf = float64 ( xn )
case int64 :
xf = float64 ( xn )
case float32 :
xf = float64 ( xn )
case float64 :
2020-08-30 11:49:26 +00:00
xf = xn
2017-07-25 18:10:40 +00:00
case time . Duration :
xf = float64 ( xn )
default :
xok = false
}
return xf , xok
}
// InDelta asserts that the two numerals are within delta of each other.
//
2023-08-05 18:43:19 +00:00
// assert.InDelta(t, math.Pi, 22/7.0, 0.01)
2017-07-25 18:10:40 +00:00
func InDelta ( t TestingT , expected , actual interface { } , delta float64 , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
af , aok := toFloat ( expected )
bf , bok := toFloat ( actual )
if ! aok || ! bok {
2022-04-25 21:50:10 +00:00
return Fail ( t , "Parameters must be numerical" , msgAndArgs ... )
}
if math . IsNaN ( af ) && math . IsNaN ( bf ) {
return true
2017-07-25 18:10:40 +00:00
}
if math . IsNaN ( af ) {
2022-04-25 21:50:10 +00:00
return Fail ( t , "Expected must not be NaN" , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
if math . IsNaN ( bf ) {
return Fail ( t , fmt . Sprintf ( "Expected %v with delta %v, but was NaN" , expected , delta ) , msgAndArgs ... )
}
dt := af - bf
if dt < - delta || dt > delta {
return Fail ( t , fmt . Sprintf ( "Max difference between %v and %v allowed is %v, but difference was %v" , expected , actual , delta , dt ) , msgAndArgs ... )
}
return true
}
// InDeltaSlice is the same as InDelta, except it compares two slices.
func InDeltaSlice ( t TestingT , expected , actual interface { } , delta float64 , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if expected == nil || actual == nil ||
reflect . TypeOf ( actual ) . Kind ( ) != reflect . Slice ||
reflect . TypeOf ( expected ) . Kind ( ) != reflect . Slice {
2022-04-25 21:50:10 +00:00
return Fail ( t , "Parameters must be slice" , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
actualSlice := reflect . ValueOf ( actual )
expectedSlice := reflect . ValueOf ( expected )
for i := 0 ; i < actualSlice . Len ( ) ; i ++ {
result := InDelta ( t , actualSlice . Index ( i ) . Interface ( ) , expectedSlice . Index ( i ) . Interface ( ) , delta , msgAndArgs ... )
if ! result {
return result
}
}
return true
}
2018-11-18 00:28:29 +00:00
// InDeltaMapValues is the same as InDelta, but it compares all values between two maps. Both maps must have exactly the same keys.
func InDeltaMapValues ( t TestingT , expected , actual interface { } , delta float64 , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if expected == nil || actual == nil ||
reflect . TypeOf ( actual ) . Kind ( ) != reflect . Map ||
reflect . TypeOf ( expected ) . Kind ( ) != reflect . Map {
return Fail ( t , "Arguments must be maps" , msgAndArgs ... )
}
expectedMap := reflect . ValueOf ( expected )
actualMap := reflect . ValueOf ( actual )
if expectedMap . Len ( ) != actualMap . Len ( ) {
return Fail ( t , "Arguments must have the same number of keys" , msgAndArgs ... )
}
for _ , k := range expectedMap . MapKeys ( ) {
ev := expectedMap . MapIndex ( k )
av := actualMap . MapIndex ( k )
if ! ev . IsValid ( ) {
return Fail ( t , fmt . Sprintf ( "missing key %q in expected map" , k ) , msgAndArgs ... )
}
if ! av . IsValid ( ) {
return Fail ( t , fmt . Sprintf ( "missing key %q in actual map" , k ) , msgAndArgs ... )
}
if ! InDelta (
t ,
ev . Interface ( ) ,
av . Interface ( ) ,
delta ,
msgAndArgs ... ,
) {
return false
}
}
return true
}
2017-07-25 18:10:40 +00:00
func calcRelativeError ( expected , actual interface { } ) ( float64 , error ) {
af , aok := toFloat ( expected )
2022-04-25 21:50:10 +00:00
bf , bok := toFloat ( actual )
if ! aok || ! bok {
return 0 , fmt . Errorf ( "Parameters must be numerical" )
}
if math . IsNaN ( af ) && math . IsNaN ( bf ) {
return 0 , nil
2017-07-25 18:10:40 +00:00
}
2020-08-30 11:49:26 +00:00
if math . IsNaN ( af ) {
return 0 , errors . New ( "expected value must not be NaN" )
}
2017-07-25 18:10:40 +00:00
if af == 0 {
return 0 , fmt . Errorf ( "expected value must have a value other than zero to calculate the relative error" )
}
2020-08-30 11:49:26 +00:00
if math . IsNaN ( bf ) {
return 0 , errors . New ( "actual value must not be NaN" )
}
2017-07-25 18:10:40 +00:00
return math . Abs ( af - bf ) / math . Abs ( af ) , nil
}
// InEpsilon asserts that expected and actual have a relative error less than epsilon
func InEpsilon ( t TestingT , expected , actual interface { } , epsilon float64 , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2020-08-30 11:49:26 +00:00
if math . IsNaN ( epsilon ) {
2024-05-23 21:44:31 +00:00
return Fail ( t , "epsilon must not be NaN" , msgAndArgs ... )
2020-08-30 11:49:26 +00:00
}
2017-07-25 18:10:40 +00:00
actualEpsilon , err := calcRelativeError ( expected , actual )
if err != nil {
return Fail ( t , err . Error ( ) , msgAndArgs ... )
}
if actualEpsilon > epsilon {
return Fail ( t , fmt . Sprintf ( "Relative error is too high: %#v (expected)\n" +
" < %#v (actual)" , epsilon , actualEpsilon ) , msgAndArgs ... )
}
return true
}
// InEpsilonSlice is the same as InEpsilon, except it compares each value from two slices.
func InEpsilonSlice ( t TestingT , expected , actual interface { } , epsilon float64 , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2024-05-23 21:44:31 +00:00
if expected == nil || actual == nil {
2022-04-25 21:50:10 +00:00
return Fail ( t , "Parameters must be slice" , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
expectedSlice := reflect . ValueOf ( expected )
2024-05-23 21:44:31 +00:00
actualSlice := reflect . ValueOf ( actual )
2017-07-25 18:10:40 +00:00
2024-05-23 21:44:31 +00:00
if expectedSlice . Type ( ) . Kind ( ) != reflect . Slice {
return Fail ( t , "Expected value must be slice" , msgAndArgs ... )
}
expectedLen := expectedSlice . Len ( )
if ! IsType ( t , expected , actual ) || ! Len ( t , actual , expectedLen ) {
return false
}
for i := 0 ; i < expectedLen ; i ++ {
if ! InEpsilon ( t , expectedSlice . Index ( i ) . Interface ( ) , actualSlice . Index ( i ) . Interface ( ) , epsilon , "at index %d" , i ) {
return false
2017-07-25 18:10:40 +00:00
}
}
return true
}
/ *
Errors
* /
// NoError asserts that a function returned no error (i.e. `nil`).
//
2023-08-05 18:43:19 +00:00
// actualObj, err := SomeFunction()
// if assert.NoError(t, err) {
// assert.Equal(t, expectedObj, actualObj)
// }
2017-07-25 18:10:40 +00:00
func NoError ( t TestingT , err error , msgAndArgs ... interface { } ) bool {
if err != nil {
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , fmt . Sprintf ( "Received unexpected error:\n%+v" , err ) , msgAndArgs ... )
}
return true
}
// Error asserts that a function returned an error (i.e. not `nil`).
//
2023-08-05 18:43:19 +00:00
// actualObj, err := SomeFunction()
// if assert.Error(t, err) {
// assert.Equal(t, expectedError, err)
// }
2017-07-25 18:10:40 +00:00
func Error ( t TestingT , err error , msgAndArgs ... interface { } ) bool {
if err == nil {
2020-08-30 11:49:26 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
return Fail ( t , "An error is expected but got nil." , msgAndArgs ... )
}
return true
}
// EqualError asserts that a function returned an error (i.e. not `nil`)
// and that it is equal to the provided error.
//
2023-08-05 18:43:19 +00:00
// actualObj, err := SomeFunction()
// assert.EqualError(t, err, expectedErrorString)
2017-07-25 18:10:40 +00:00
func EqualError ( t TestingT , theError error , errString string , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if ! Error ( t , theError , msgAndArgs ... ) {
return false
}
expected := errString
actual := theError . Error ( )
// don't need to use deep equals here, we know they are both strings
if expected != actual {
return Fail ( t , fmt . Sprintf ( "Error message not equal:\n" +
"expected: %q\n" +
2018-11-18 00:28:29 +00:00
"actual : %q" , expected , actual ) , msgAndArgs ... )
2017-07-25 18:10:40 +00:00
}
return true
}
2022-04-25 21:50:10 +00:00
// ErrorContains asserts that a function returned an error (i.e. not `nil`)
// and that the error contains the specified substring.
//
2023-08-05 18:43:19 +00:00
// actualObj, err := SomeFunction()
// assert.ErrorContains(t, err, expectedErrorSubString)
2022-04-25 21:50:10 +00:00
func ErrorContains ( t TestingT , theError error , contains string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if ! Error ( t , theError , msgAndArgs ... ) {
return false
}
actual := theError . Error ( )
if ! strings . Contains ( actual , contains ) {
return Fail ( t , fmt . Sprintf ( "Error %#v does not contain %#v" , actual , contains ) , msgAndArgs ... )
}
return true
}
2017-07-25 18:10:40 +00:00
// matchRegexp return true if a specified regexp matches a string.
func matchRegexp ( rx interface { } , str interface { } ) bool {
var r * regexp . Regexp
if rr , ok := rx . ( * regexp . Regexp ) ; ok {
r = rr
} else {
r = regexp . MustCompile ( fmt . Sprint ( rx ) )
}
return ( r . FindStringIndex ( fmt . Sprint ( str ) ) != nil )
}
// Regexp asserts that a specified regexp matches a string.
//
2023-08-05 18:43:19 +00:00
// assert.Regexp(t, regexp.MustCompile("start"), "it's starting")
// assert.Regexp(t, "start...$", "it's not starting")
2017-07-25 18:10:40 +00:00
func Regexp ( t TestingT , rx interface { } , str interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
match := matchRegexp ( rx , str )
if ! match {
Fail ( t , fmt . Sprintf ( "Expect \"%v\" to match \"%v\"" , str , rx ) , msgAndArgs ... )
}
return match
}
// NotRegexp asserts that a specified regexp does not match a string.
//
2023-08-05 18:43:19 +00:00
// assert.NotRegexp(t, regexp.MustCompile("starts"), "it's starting")
// assert.NotRegexp(t, "^start", "it's not starting")
2017-07-25 18:10:40 +00:00
func NotRegexp ( t TestingT , rx interface { } , str interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
match := matchRegexp ( rx , str )
if match {
Fail ( t , fmt . Sprintf ( "Expect \"%v\" to NOT match \"%v\"" , str , rx ) , msgAndArgs ... )
}
return ! match
}
2018-11-18 00:28:29 +00:00
// Zero asserts that i is the zero value for its type.
2017-07-25 18:10:40 +00:00
func Zero ( t TestingT , i interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if i != nil && ! reflect . DeepEqual ( i , reflect . Zero ( reflect . TypeOf ( i ) ) . Interface ( ) ) {
return Fail ( t , fmt . Sprintf ( "Should be zero, but was %v" , i ) , msgAndArgs ... )
}
return true
}
2018-11-18 00:28:29 +00:00
// NotZero asserts that i is not the zero value for its type.
2017-07-25 18:10:40 +00:00
func NotZero ( t TestingT , i interface { } , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
if i == nil || reflect . DeepEqual ( i , reflect . Zero ( reflect . TypeOf ( i ) ) . Interface ( ) ) {
return Fail ( t , fmt . Sprintf ( "Should not be zero, but was %v" , i ) , msgAndArgs ... )
}
return true
}
2020-05-23 22:06:21 +00:00
// FileExists checks whether a file exists in the given path. It also fails if
// the path points to a directory or there is an error when trying to check the file.
2018-11-18 00:28:29 +00:00
func FileExists ( t TestingT , path string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
info , err := os . Lstat ( path )
if err != nil {
if os . IsNotExist ( err ) {
return Fail ( t , fmt . Sprintf ( "unable to find file %q" , path ) , msgAndArgs ... )
}
return Fail ( t , fmt . Sprintf ( "error when running os.Lstat(%q): %s" , path , err ) , msgAndArgs ... )
}
if info . IsDir ( ) {
return Fail ( t , fmt . Sprintf ( "%q is a directory" , path ) , msgAndArgs ... )
}
return true
}
2020-05-23 22:06:21 +00:00
// NoFileExists checks whether a file does not exist in a given path. It fails
// if the path points to an existing _file_ only.
func NoFileExists ( t TestingT , path string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
info , err := os . Lstat ( path )
if err != nil {
return true
}
if info . IsDir ( ) {
return true
}
return Fail ( t , fmt . Sprintf ( "file %q exists" , path ) , msgAndArgs ... )
}
// DirExists checks whether a directory exists in the given path. It also fails
// if the path is a file rather a directory or there is an error checking whether it exists.
2018-11-18 00:28:29 +00:00
func DirExists ( t TestingT , path string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
info , err := os . Lstat ( path )
if err != nil {
if os . IsNotExist ( err ) {
return Fail ( t , fmt . Sprintf ( "unable to find file %q" , path ) , msgAndArgs ... )
}
return Fail ( t , fmt . Sprintf ( "error when running os.Lstat(%q): %s" , path , err ) , msgAndArgs ... )
}
if ! info . IsDir ( ) {
return Fail ( t , fmt . Sprintf ( "%q is a file" , path ) , msgAndArgs ... )
}
return true
}
2020-05-23 22:06:21 +00:00
// NoDirExists checks whether a directory does not exist in the given path.
// It fails if the path points to an existing _directory_ only.
func NoDirExists ( t TestingT , path string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
info , err := os . Lstat ( path )
if err != nil {
if os . IsNotExist ( err ) {
return true
}
return true
}
if ! info . IsDir ( ) {
return true
}
return Fail ( t , fmt . Sprintf ( "directory %q exists" , path ) , msgAndArgs ... )
}
2017-07-25 18:10:40 +00:00
// JSONEq asserts that two JSON strings are equivalent.
//
2023-08-05 18:43:19 +00:00
// assert.JSONEq(t, `{"hello": "world", "foo": "bar"}`, `{"foo": "bar", "hello": "world"}`)
2017-07-25 18:10:40 +00:00
func JSONEq ( t TestingT , expected string , actual string , msgAndArgs ... interface { } ) bool {
2018-11-18 00:28:29 +00:00
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2017-07-25 18:10:40 +00:00
var expectedJSONAsInterface , actualJSONAsInterface interface { }
if err := json . Unmarshal ( [ ] byte ( expected ) , & expectedJSONAsInterface ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Expected value ('%s') is not valid json.\nJSON parsing error: '%s'" , expected , err . Error ( ) ) , msgAndArgs ... )
}
if err := json . Unmarshal ( [ ] byte ( actual ) , & actualJSONAsInterface ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Input ('%s') needs to be valid json.\nJSON parsing error: '%s'" , actual , err . Error ( ) ) , msgAndArgs ... )
}
return Equal ( t , expectedJSONAsInterface , actualJSONAsInterface , msgAndArgs ... )
}
2019-09-07 20:46:58 +00:00
// YAMLEq asserts that two YAML strings are equivalent.
func YAMLEq ( t TestingT , expected string , actual string , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
var expectedYAMLAsInterface , actualYAMLAsInterface interface { }
if err := yaml . Unmarshal ( [ ] byte ( expected ) , & expectedYAMLAsInterface ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Expected value ('%s') is not valid yaml.\nYAML parsing error: '%s'" , expected , err . Error ( ) ) , msgAndArgs ... )
}
if err := yaml . Unmarshal ( [ ] byte ( actual ) , & actualYAMLAsInterface ) ; err != nil {
return Fail ( t , fmt . Sprintf ( "Input ('%s') needs to be valid yaml.\nYAML error: '%s'" , actual , err . Error ( ) ) , msgAndArgs ... )
}
return Equal ( t , expectedYAMLAsInterface , actualYAMLAsInterface , msgAndArgs ... )
}
2017-07-25 18:10:40 +00:00
func typeAndKind ( v interface { } ) ( reflect . Type , reflect . Kind ) {
t := reflect . TypeOf ( v )
k := t . Kind ( )
if k == reflect . Ptr {
t = t . Elem ( )
k = t . Kind ( )
}
return t , k
}
// diff returns a diff of both values as long as both are of the same type and
2019-01-31 16:06:36 +00:00
// are a struct, map, slice, array or string. Otherwise it returns an empty string.
2017-07-25 18:10:40 +00:00
func diff ( expected interface { } , actual interface { } ) string {
if expected == nil || actual == nil {
return ""
}
et , ek := typeAndKind ( expected )
at , _ := typeAndKind ( actual )
if et != at {
return ""
}
2018-11-18 00:28:29 +00:00
if ek != reflect . Struct && ek != reflect . Map && ek != reflect . Slice && ek != reflect . Array && ek != reflect . String {
2017-07-25 18:10:40 +00:00
return ""
}
2018-11-18 00:28:29 +00:00
var e , a string
2022-04-25 21:50:10 +00:00
switch et {
case reflect . TypeOf ( "" ) :
2019-09-07 20:46:58 +00:00
e = reflect . ValueOf ( expected ) . String ( )
a = reflect . ValueOf ( actual ) . String ( )
2022-04-25 21:50:10 +00:00
case reflect . TypeOf ( time . Time { } ) :
e = spewConfigStringerEnabled . Sdump ( expected )
a = spewConfigStringerEnabled . Sdump ( actual )
default :
e = spewConfig . Sdump ( expected )
a = spewConfig . Sdump ( actual )
2018-11-18 00:28:29 +00:00
}
2017-07-25 18:10:40 +00:00
diff , _ := difflib . GetUnifiedDiffString ( difflib . UnifiedDiff {
A : difflib . SplitLines ( e ) ,
B : difflib . SplitLines ( a ) ,
FromFile : "Expected" ,
FromDate : "" ,
ToFile : "Actual" ,
ToDate : "" ,
Context : 1 ,
} )
return "\n\nDiff:\n" + diff
}
func isFunction ( arg interface { } ) bool {
if arg == nil {
return false
}
return reflect . TypeOf ( arg ) . Kind ( ) == reflect . Func
}
var spewConfig = spew . ConfigState {
Indent : " " ,
DisablePointerAddresses : true ,
DisableCapacities : true ,
SortKeys : true ,
2020-08-30 11:49:26 +00:00
DisableMethods : true ,
2021-02-01 20:29:04 +00:00
MaxDepth : 10 ,
2017-07-25 18:10:40 +00:00
}
2018-11-18 00:28:29 +00:00
2022-04-25 21:50:10 +00:00
var spewConfigStringerEnabled = spew . ConfigState {
Indent : " " ,
DisablePointerAddresses : true ,
DisableCapacities : true ,
SortKeys : true ,
MaxDepth : 10 ,
}
2018-11-18 00:28:29 +00:00
type tHelper interface {
Helper ( )
}
2019-09-07 20:46:58 +00:00
// Eventually asserts that given condition will be met in waitFor time,
// periodically checking target function each tick.
//
2023-08-05 18:43:19 +00:00
// assert.Eventually(t, func() bool { return true; }, time.Second, 10*time.Millisecond)
2019-09-07 20:46:58 +00:00
func Eventually ( t TestingT , condition func ( ) bool , waitFor time . Duration , tick time . Duration , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2020-05-23 22:06:21 +00:00
ch := make ( chan bool , 1 )
2019-09-07 20:46:58 +00:00
timer := time . NewTimer ( waitFor )
defer timer . Stop ( )
2020-05-23 22:06:21 +00:00
ticker := time . NewTicker ( tick )
2019-09-07 20:46:58 +00:00
defer ticker . Stop ( )
2020-05-23 22:06:21 +00:00
for tick := ticker . C ; ; {
2019-09-07 20:46:58 +00:00
select {
case <- timer . C :
return Fail ( t , "Condition never satisfied" , msgAndArgs ... )
2020-05-23 22:06:21 +00:00
case <- tick :
tick = nil
go func ( ) { ch <- condition ( ) } ( )
case v := <- ch :
if v {
2019-09-07 20:46:58 +00:00
return true
}
2020-05-23 22:06:21 +00:00
tick = ticker . C
}
}
}
2023-08-05 18:43:19 +00:00
// CollectT implements the TestingT interface and collects all errors.
type CollectT struct {
errors [ ] error
}
// Errorf collects the error.
func ( c * CollectT ) Errorf ( format string , args ... interface { } ) {
c . errors = append ( c . errors , fmt . Errorf ( format , args ... ) )
}
// FailNow panics.
2024-05-23 21:44:31 +00:00
func ( * CollectT ) FailNow ( ) {
2023-08-05 18:43:19 +00:00
panic ( "Assertion failed" )
}
2024-05-23 21:44:31 +00:00
// Deprecated: That was a method for internal usage that should not have been published. Now just panics.
func ( * CollectT ) Reset ( ) {
panic ( "Reset() is deprecated" )
2023-08-05 18:43:19 +00:00
}
2024-05-23 21:44:31 +00:00
// Deprecated: That was a method for internal usage that should not have been published. Now just panics.
func ( * CollectT ) Copy ( TestingT ) {
panic ( "Copy() is deprecated" )
2023-08-05 18:43:19 +00:00
}
// EventuallyWithT asserts that given condition will be met in waitFor time,
// periodically checking target function each tick. In contrast to Eventually,
// it supplies a CollectT to the condition function, so that the condition
// function can use the CollectT to call other assertions.
// The condition is considered "met" if no errors are raised in a tick.
// The supplied CollectT collects all errors from one tick (if there are any).
// If the condition is not met before waitFor, the collected errors of
// the last tick are copied to t.
//
// externalValue := false
// go func() {
// time.Sleep(8*time.Second)
// externalValue = true
// }()
// assert.EventuallyWithT(t, func(c *assert.CollectT) {
// // add assertions as needed; any assertion failure will fail the current tick
// assert.True(c, externalValue, "expected 'externalValue' to be true")
// }, 1*time.Second, 10*time.Second, "external state has not changed to 'true'; still false")
func EventuallyWithT ( t TestingT , condition func ( collect * CollectT ) , waitFor time . Duration , tick time . Duration , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
2024-05-23 21:44:31 +00:00
var lastFinishedTickErrs [ ] error
ch := make ( chan [ ] error , 1 )
2023-08-05 18:43:19 +00:00
timer := time . NewTimer ( waitFor )
defer timer . Stop ( )
ticker := time . NewTicker ( tick )
defer ticker . Stop ( )
for tick := ticker . C ; ; {
select {
case <- timer . C :
2024-05-23 21:44:31 +00:00
for _ , err := range lastFinishedTickErrs {
t . Errorf ( "%v" , err )
}
2023-08-05 18:43:19 +00:00
return Fail ( t , "Condition never satisfied" , msgAndArgs ... )
case <- tick :
tick = nil
go func ( ) {
2024-05-23 21:44:31 +00:00
collect := new ( CollectT )
defer func ( ) {
ch <- collect . errors
} ( )
2023-08-05 18:43:19 +00:00
condition ( collect )
} ( )
2024-05-23 21:44:31 +00:00
case errs := <- ch :
if len ( errs ) == 0 {
2023-08-05 18:43:19 +00:00
return true
}
2024-05-23 21:44:31 +00:00
// Keep the errors from the last ended condition, so that they can be copied to t if timeout is reached.
lastFinishedTickErrs = errs
2023-08-05 18:43:19 +00:00
tick = ticker . C
}
}
}
2020-05-23 22:06:21 +00:00
// Never asserts that the given condition doesn't satisfy in waitFor time,
// periodically checking the target function each tick.
//
2023-08-05 18:43:19 +00:00
// assert.Never(t, func() bool { return false; }, time.Second, 10*time.Millisecond)
2020-05-23 22:06:21 +00:00
func Never ( t TestingT , condition func ( ) bool , waitFor time . Duration , tick time . Duration , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
ch := make ( chan bool , 1 )
timer := time . NewTimer ( waitFor )
defer timer . Stop ( )
ticker := time . NewTicker ( tick )
defer ticker . Stop ( )
for tick := ticker . C ; ; {
select {
case <- timer . C :
return true
case <- tick :
tick = nil
go func ( ) { ch <- condition ( ) } ( )
case v := <- ch :
if v {
return Fail ( t , "Condition satisfied" , msgAndArgs ... )
}
tick = ticker . C
2019-09-07 20:46:58 +00:00
}
}
}
2021-02-01 20:29:04 +00:00
// ErrorIs asserts that at least one of the errors in err's chain matches target.
// This is a wrapper for errors.Is.
func ErrorIs ( t TestingT , err , target error , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if errors . Is ( err , target ) {
return true
}
var expectedText string
if target != nil {
expectedText = target . Error ( )
}
chain := buildErrorChainString ( err )
return Fail ( t , fmt . Sprintf ( "Target error should be in err chain:\n" +
"expected: %q\n" +
"in chain: %s" , expectedText , chain ,
) , msgAndArgs ... )
}
// NotErrorIs asserts that at none of the errors in err's chain matches target.
// This is a wrapper for errors.Is.
func NotErrorIs ( t TestingT , err , target error , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if ! errors . Is ( err , target ) {
return true
}
var expectedText string
if target != nil {
expectedText = target . Error ( )
}
chain := buildErrorChainString ( err )
return Fail ( t , fmt . Sprintf ( "Target error should not be in err chain:\n" +
"found: %q\n" +
"in chain: %s" , expectedText , chain ,
) , msgAndArgs ... )
}
// ErrorAs asserts that at least one of the errors in err's chain matches target, and if so, sets target to that error value.
// This is a wrapper for errors.As.
func ErrorAs ( t TestingT , err error , target interface { } , msgAndArgs ... interface { } ) bool {
if h , ok := t . ( tHelper ) ; ok {
h . Helper ( )
}
if errors . As ( err , target ) {
return true
}
chain := buildErrorChainString ( err )
return Fail ( t , fmt . Sprintf ( "Should be in error chain:\n" +
"expected: %q\n" +
"in chain: %s" , target , chain ,
) , msgAndArgs ... )
}
func buildErrorChainString ( err error ) string {
if err == nil {
return ""
}
e := errors . Unwrap ( err )
chain := fmt . Sprintf ( "%q" , err . Error ( ) )
for e != nil {
chain += fmt . Sprintf ( "\n\t%q" , e . Error ( ) )
e = errors . Unwrap ( e )
}
return chain
}