compare

Documentation

Index

• func HasNilDifference(a, b interface{}) bool
• func IsNil(i interface{}) bool
• func IsNotNil(i interface{}) bool
• func MapStringStringEqual(a, b map[string]string) bool
• func MapStringStringPEqual(a, b map[string]*string) bool
• func SliceStringEqual(a, b []string) bool
• func SliceStringPEqual(a, b []*string) bool
• type Delta
  • func NewDelta() *Delta
  • func (d *Delta) Add(path string, a interface{}, b interface{})
  • func (d *Delta) DifferentAt(subject string) bool
  • func (d *Delta) DifferentExcept(exceptPaths ...string) bool
• type Difference
• type Path
  • func NewPath(dotted string) Path
  • func (p Path) Contains(subject string) bool
  • func (p Path) MarshalJSON() ([]byte, error)
  • func (p Path) Pop()
  • func (p Path) Push(part string)

Functions

func HasNilDifference

func HasNilDifference(a, b interface{}) bool

HasNilDifference returns true if the supplied subjects' nilness is different

func IsNil

func IsNil(i interface{}) bool

IsNil checks the passed interface argument for Nil value. For interfaces, only 'i==nil' check is not sufficient. https://tour.golang.org/methods/12 More details: https://mangatmodi.medium.com/go-check-nil-interface-the-right-way-d142776edef1

func IsNotNil

func IsNotNil(i interface{}) bool

IsNotNil returns true if the supplied interface is not nil, false otherwise

func MapStringStringEqual

func MapStringStringEqual(a, b map[string]string) bool

MapStringStringEqual returns true if the supplied maps are equal

func MapStringStringPEqual

func MapStringStringPEqual(a, b map[string]*string) bool

MapStringStringPEqual returns true if the supplied maps are equal

func SliceStringEqual

func SliceStringEqual(a, b []string) bool

SliceStringEqual returns true if the supplied slices of string have equal values regardless of order.

func SliceStringPEqual

func SliceStringPEqual(a, b []*string) bool

SliceStringPEqual returns true if the supplied slices of string pointers have equal values regardless of order.

Types

type Delta

type Delta struct {
	// Differences is a slice of *ackcompare.Difference structs representing
	// differences in values of two resources under comparison
	Differences []*Difference
}

Delta represents differences between two resources. The underlying types of the two supplied resources should be the same.

func NewDelta

func NewDelta() *Delta

NewDelta returns a new Delta struct used to compare two resources.

func (*Delta) Add

func (d *Delta) Add(
	path string,
	a interface{},
	b interface{},
)

Add adds a new Difference to the Delta

func (*Delta) DifferentAt

func (d *Delta) DifferentAt(subject string) bool

DifferentAt returns whether there is a difference at the supplied JSONPath expression in the resources under comparison

func (*Delta) DifferentExcept

func (d *Delta) DifferentExcept(
	exceptPaths ...string,
) bool

DifferentExcept returns true if the delta contains any differences *other* than any of the supplied path strings.

This method is useful if you have a scenario where you don't want to proceed with a modification action if certain fields in a resource have not been changed.

For example, consider this code:

if delta.DifferentAt("Spec.Tags") {
    if err = rm.SyncTags(ctx, desired, latest); err != nil {
        return nil, err
    }
}

if !delta.DifferentExcept("Spec.Tags") {
    // We don't want to proceed to call the ModifyDBInstance API since
    // no other resource fields have changed.
    return desired, nil
}

might be placed in an sdk_update_pre_build_request custom code hook to prevent the ModifyDBInstance call from being executed if the DBInstance's Tags field is the only field with changes.

type Difference

type Difference struct {
	// Path is the field path to the detected difference between resources
	// under comparison
	Path Path
	// A is the value of the first resource under comparison at the Path
	A interface{}
	// B is the value of the first resource under comparison at the Path
	B interface{}
}

Difference contains the difference in values for a specified field path into two compared resources.

type Path

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

Path provides a JSONPath-like struct and field-member "route" to a particular field within a compared struct. Path implements json.Marshaler interface.

func NewPath

func NewPath(dotted string) Path

NewPath returns a new Path struct pointer from a dotted-notation string, e.g. "Author.Name"

func (Path) Contains

func (p Path) Contains(subject string) bool

Contains returns true if the supplied string, delimited on ".", matches p.parts up to the length of the supplied string.

e.g. if the Path p represents "A.B":
	subject "A" -> true
	subject "A.B" -> true
	subject "A.B.C" -> false
	subject "B" -> false
	subject "A.C" -> false

func (Path) MarshalJSON

func (p Path) MarshalJSON() ([]byte, error)

MarshalJSON returns the JSON encoding of a Path object.

func (Path) Pop

func (p Path) Pop()

Pop removes the last part from the Path

func (Path) Push

func (p Path) Push(part string)

Push adds a new part to the Path.