testutil

Documentation

Index

• func AssertEqual(t *testing.T, expected, actual interface{}, msgAndArgs ...interface{})
• func AssertNotEqual(t *testing.T, expected, actual interface{}, msgAndArgs ...interface{})
• func Equal(expected interface{}) *cmpMatcher
• func EqualErrorString(err string) equalErrorString
• func EqualErrorType(err error) equalErrorType
• func NewFakeRESTMapper(gvks ...schema.GroupVersionKind) meta.RESTMapper
• func ToIdentifier(t *testing.T, manifest string) object.ObjMetadata
• func Unstructured(t *testing.T, manifest string, mutators ...Mutator) *unstructured.Unstructured
• func VerifyEvents(expEvents []ExpEvent, events []event.Event) error
• type ExpActionGroupEvent
• type ExpApplyEvent
• type ExpDeleteEvent
• type ExpErrorEvent
• type ExpEvent
  • func EventToExpEvent(e event.Event) ExpEvent
  • func EventsToExpEvents(events []event.Event) []ExpEvent
  • func RemoveEqualEvents(in []ExpEvent, expected ExpEvent) ([]ExpEvent, int)
• type ExpInitEvent
• type ExpPruneEvent
• type ExpStatusEvent
• type ExpWaitEvent
• type GroupedEventsByID
  • func (ape GroupedEventsByID) Len() int
  • func (ape GroupedEventsByID) Less(i, j int) bool
  • func (ape GroupedEventsByID) Swap(i, j int)
• type Mutator
  • func AddDependsOn(t *testing.T, deps ...object.ObjMetadata) Mutator
  • func AddOwningInv(t *testing.T, inv string) Mutator
• type TestFilesystem
  • func Setup(t *testing.T, dirs ...string) TestFilesystem
  • func (tf TestFilesystem) Clean()
  • func (tf TestFilesystem) GetRootDir() string
  • func (tf TestFilesystem) WriteFile(t *testing.T, path string, value []byte)

Functions

func AssertEqual

func AssertEqual(t *testing.T, expected, actual interface{}, msgAndArgs ...interface{})

AssertEqual fails the test if the actual value does not deeply equal the expected value. Prints a diff on failure.

func AssertNotEqual

func AssertNotEqual(t *testing.T, expected, actual interface{}, msgAndArgs ...interface{})

AssertNotEqual fails the test if the actual value deeply equals the expected value. Prints a diff on failure.

func Equal

func Equal(expected interface{}) *cmpMatcher

Equal returns a matcher for use with Gomega that uses go-cmp's cmp.Equal to compare and cmp.Diff to show the difference, if there is one.

Example Usage: Expect(receivedEvents).To(testutil.Equal(expectedEvents))

func EqualErrorString

func EqualErrorString(err string) equalErrorString

EqualErrorString returns an error with an Is(error)bool function that matches any error with the same Error() as the supplied string value.

Use with testutil.Equal to handle error comparisons.

func EqualErrorType

func EqualErrorType(err error) equalErrorType

EqualErrorType returns an error with an Is(error)bool function that matches any error with the same type as the supplied error.

Use with testutil.Equal to handle error comparisons.

func NewFakeRESTMapper

func NewFakeRESTMapper(gvks ...schema.GroupVersionKind) meta.RESTMapper

func ToIdentifier

func ToIdentifier(t *testing.T, manifest string) object.ObjMetadata

ToIdentifier translates object yaml config into ObjMetadata.

func Unstructured

func Unstructured(t *testing.T, manifest string, mutators ...Mutator) *unstructured.Unstructured

Unstructured translates the passed object config string into an object in Unstructured format. The mutators modify the config yaml before returning the object.

func VerifyEvents

func VerifyEvents(expEvents []ExpEvent, events []event.Event) error

Types

type ExpActionGroupEvent

type ExpActionGroupEvent struct {
	GroupName string
	Action    event.ResourceAction
	Type      event.ActionGroupEventType
}

type ExpApplyEvent

type ExpApplyEvent struct {
	GroupName  string
	Operation  event.ApplyEventOperation
	Identifier object.ObjMetadata
	Error      error
}

type ExpDeleteEvent

type ExpDeleteEvent struct {
	GroupName  string
	Operation  event.DeleteEventOperation
	Identifier object.ObjMetadata
	Error      error
}

type ExpErrorEvent

type ExpErrorEvent struct {
	Err error
}

type ExpEvent

type ExpEvent struct {
	EventType event.Type

	InitEvent        *ExpInitEvent
	ErrorEvent       *ExpErrorEvent
	ActionGroupEvent *ExpActionGroupEvent
	ApplyEvent       *ExpApplyEvent
	StatusEvent      *ExpStatusEvent
	PruneEvent       *ExpPruneEvent
	DeleteEvent      *ExpDeleteEvent
	WaitEvent        *ExpWaitEvent
}

func EventToExpEvent

func EventToExpEvent(e event.Event) ExpEvent

func EventsToExpEvents

func EventsToExpEvents(events []event.Event) []ExpEvent

func RemoveEqualEvents

func RemoveEqualEvents(in []ExpEvent, expected ExpEvent) ([]ExpEvent, int)

type ExpInitEvent

type ExpInitEvent struct {
}

type ExpPruneEvent

type ExpPruneEvent struct {
	GroupName  string
	Operation  event.PruneEventOperation
	Identifier object.ObjMetadata
	Error      error
}

type ExpStatusEvent

type ExpStatusEvent struct {
	Identifier object.ObjMetadata
	Status     status.Status
	Error      error
}

type ExpWaitEvent

type ExpWaitEvent struct {
	GroupName  string
	Operation  event.WaitEventOperation
	Identifier object.ObjMetadata
}

type GroupedEventsByID

type GroupedEventsByID []ExpEvent

GroupedEventsByID implements sort.Interface for []ExpEvent based on the serialized ObjMetadata of Apply, Prune, and Delete events within the same task group. This makes testing events easier, because apply/prune/delete order is non-deterministic within each task group. This is only needed if you expect to have multiple apply/prune/delete events in the same task group.

func (GroupedEventsByID) Len

func (ape GroupedEventsByID) Len() int

func (GroupedEventsByID) Less

func (ape GroupedEventsByID) Less(i, j int) bool

func (GroupedEventsByID) Swap

func (ape GroupedEventsByID) Swap(i, j int)

type Mutator

type Mutator interface {
	Mutate(u *unstructured.Unstructured)
}

Mutator inteface defines a function to update an object while translating it unto Unstructured format from yaml config.

func AddDependsOn

func AddDependsOn(t *testing.T, deps ...object.ObjMetadata) Mutator

AddDependsOn returns a testutil.Mutator which adds the passed objects as a depends-on annotation to the object which is mutated. Multiple objects passed in means multiple depends on objects in the annotation separated by a comma.

func AddOwningInv

func AddOwningInv(t *testing.T, inv string) Mutator

AddOwningInv returns a Mutator which adds the passed inv string as the owning inventory annotation.

type TestFilesystem

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

TestFilesystem creates directories and files for testing

func Setup

func Setup(t *testing.T, dirs ...string) TestFilesystem

Setupd creates directories in the test filesystem, returning the TestFilesystem.

func (TestFilesystem) Clean

func (tf TestFilesystem) Clean()

Clean deletes the test filesystem.

func (TestFilesystem) GetRootDir

func (tf TestFilesystem) GetRootDir() string

GetRootDir returns the path to the root of the test filesystem.

func (TestFilesystem) WriteFile

func (tf TestFilesystem) WriteFile(t *testing.T, path string, value []byte)

WriteFile writes a file in the test filesystem at relative "path" containing the bytes "value".