test

Documentation

Overview

Package test contains utility methods for testing.

Index

• Constants
• Variables
• func ByteSlicesBackedBySameData(a, b []byte) bool
• func CmpMatcher(x interface{}, opts ...cmp.Option) gomock.Matcher
• func ConvertToTestExtendedOptions(opts *protobuftypes.Struct) (namespace.ExtendedOptions, error)
• func Diff(expected, actual string) string
• func MustPrettyJSONArray(t *testing.T, value xjson.Array) string
• func MustPrettyJSONMap(t *testing.T, value xjson.Map) string
• func MustPrettyJSONString(t *testing.T, str string) string
• func NewController(t require.TestingT) *gomock.Controller
• func NewCorruptingFile(fd xos.File, corruptionProbability float64, seed int64) xos.File
• func NewLogger(t *testing.T) *zap.Logger
• func NewTestExtendedOptionsJSON(value string) xjson.Map
• func NewTestExtendedOptionsProto(value string) *nsproto.ExtendedOptions
• type Reporter
  • func (r Reporter) Errorf(format string, args ...interface{})
  • func (r Reporter) Fatalf(format string, args ...interface{})

Constants

const TypeURLPrefix = "testm3db.io/"

TypeURLPrefix is a type URL prefix for storing in protobuf Any messages.

Variables

var IdentTransformer = cmp.Transformer("",
	func(id ident.ID) ident.BytesID { return ident.BytesID(id.Bytes()) })

IdentTransformer transforms any ident.ID into ident.BytesID to make it easier for comparison.

Functions

func ByteSlicesBackedBySameData

func ByteSlicesBackedBySameData(a, b []byte) bool

ByteSlicesBackedBySameData returns a bool indicating if the raw backing bytes under the []byte slice point to the same memory.

func CmpMatcher

func CmpMatcher(x interface{}, opts ...cmp.Option) gomock.Matcher

CmpMatcher returns a new matcher backed by go-cmp/cmp.Equal.

func ConvertToTestExtendedOptions

func ConvertToTestExtendedOptions(
	opts *protobuftypes.Struct,
) (namespace.ExtendedOptions, error)

ConvertToTestExtendedOptions is ExtendedOptsConverter for testExtendedOptions.

func Diff

func Diff(expected, actual string) string

Diff is a helper method to print a terminal pretty diff of two strings for test output purposes.

func MustPrettyJSONArray

func MustPrettyJSONArray(t *testing.T, value xjson.Array) string

MustPrettyJSONArray returns an indented JSON string of the object.

func MustPrettyJSONMap

func MustPrettyJSONMap(t *testing.T, value xjson.Map) string

MustPrettyJSONMap returns an indented JSON string of the object.

func MustPrettyJSONString

func MustPrettyJSONString(t *testing.T, str string) string

MustPrettyJSONString returns an indented version of the JSON.

func NewController

func NewController(t require.TestingT) *gomock.Controller

NewController provides a gomock.Controller wrapped with a xtest.Reporter, which gives more useful error modes on unexpected mock calls. See xtest.Reporter for more context.

func NewCorruptingFile

func NewCorruptingFile(
	fd xos.File,
	corruptionProbability float64,
	seed int64,
) xos.File

NewCorruptingFile creates a new corrupting file.

func NewLogger

func NewLogger(t *testing.T) *zap.Logger

NewLogger returns a new test logger.

func NewTestExtendedOptionsJSON

func NewTestExtendedOptionsJSON(value string) xjson.Map

NewTestExtendedOptionsJSON returns a json Map for testExtendedOptions.

func NewTestExtendedOptionsProto

func NewTestExtendedOptionsProto(value string) *nsproto.ExtendedOptions

NewTestExtendedOptionsProto construct a new protobuf ExtendedOptions message.

Types

type Reporter

type Reporter struct {
	T require.TestingT
}

Reporter wraps a *testing.T, and provides a more useful failure mode when interacting with gomock.Controller.

For example, consider:

func TestMyThing(t *testing.T) {
  mockCtrl := gomock.NewController(t)
  defer mockCtrl.Finish()
  mockObj := something.NewMockMyInterface(mockCtrl)
  go func() {
    mockObj.SomeMethod(4, "blah")
  }
}

It hangs without any indication that it's missing an EXPECT() on `mockObj`. Providing the Reporter to the gomock.Controller ctor avoids this, and terminates with useful feedback. i.e.

func TestMyThing(t *testing.T) {
  mockCtrl := gomock.NewController(test.Reporter{t})
  defer mockCtrl.Finish()
  mockObj := something.NewMockMyInterface(mockCtrl)
  go func() {
    mockObj.SomeMethod(4, "blah") // crashes the test now
  }
}

func (Reporter) Errorf

func (r Reporter) Errorf(format string, args ...interface{})

Errorf is equivalent testing.T.Errorf.

func (Reporter) Fatalf

func (r Reporter) Fatalf(format string, args ...interface{})

Fatalf crashes the program with a panic to allow users to diagnose missing expects.