lockedresource

Documentation

Index

• Variables
• func AsListOfUnstructured(lockedResources []LockedResource) []unstructured.Unstructured
• func GetResources(lockedResources []LockedResource) []apis.Resource
• type LockedResource
  • func GetLockedResources(resources []apis.LockedResource) ([]LockedResource, error)
  • func GetLockedResourcesFromTemplates(resources []apis.LockedResourceTemplate, params interface{}) ([]LockedResource, error)
  • func (lr *LockedResource) GetKey() string
• type Set
  • func Difference(set1 *Set, sets ...*Set) *Set
  • func Intersection(sets ...*Set) *Set
  • func New(ts ...LockedResource) *Set
  • func NewWithSize(size int) *Set
  • func SymmetricDifference(s *Set, t *Set) *Set
  • func Union(sets ...*Set) *Set
  • func (s *Set) Add(items ...LockedResource)
  • func (s *Set) Clear()
  • func (s *Set) Copy() *Set
  • func (s *Set) Each(f func(item LockedResource) bool)
  • func (s *Set) Has(items ...LockedResource) bool
  • func (s *Set) HasAny(items ...LockedResource) bool
  • func (s *Set) IsEmpty() bool
  • func (s *Set) IsEqual(t *Set) bool
  • func (s *Set) IsSubset(t *Set) bool
  • func (s *Set) IsSuperset(t *Set) bool
  • func (s *Set) List() []LockedResource
  • func (s *Set) Merge(t *Set)
  • func (s *Set) Pop() LockedResource
  • func (s *Set) Pop2() (LockedResource, bool)
  • func (s *Set) Remove(items ...LockedResource)
  • func (s *Set) Separate(t *Set)
  • func (s *Set) Size() int
  • func (s *Set) String() string

Variables

var DefaultExcludedPaths = []string{".metadata", ".status", ".spec.replicas"}

DefaultExcludedPaths represents paths that are exlcuded by default in all resources

var DefaultExcludedPathsSet = strset.New(DefaultExcludedPaths...)

DefaultExcludedPathsSet represents paths that are exlcuded by default in all resources

Functions

func AsListOfUnstructured

func AsListOfUnstructured(lockedResources []LockedResource) []unstructured.Unstructured

AsListOfUnstructured given a list of LockedResource, returns a list of unstructured.Unstructured

func GetResources

func GetResources(lockedResources []LockedResource) []apis.Resource

GetResources returs an arrays of apis.Resources from an arya of LockedResources, useful for mass operations on the LockedResources

Types

type LockedResource

type LockedResource struct {
	// unstructured.Unstructured is the resource to be locked
	unstructured.Unstructured
	// ExcludedPaths are the jsonPaths to be excluded when consider whether the resource has changed
	ExcludedPaths []string
}

LockedResource represents a resource to be locked down by a LockedResourceReconciler within a LockedResourceManager

func GetLockedResources

func GetLockedResources(resources []apis.LockedResource) ([]LockedResource, error)

GetLockedResources turns an array of Resources as read from an API into an array of LockedResources, usable by the LockedResourceManager

func GetLockedResourcesFromTemplates

func GetLockedResourcesFromTemplates(resources []apis.LockedResourceTemplate, params interface{}) ([]LockedResource, error)

GetLockedResourcesFromTemplate turns an array of ResourceTemplates as read from an API into an array of LockedResources using a params to process the templates

func (*LockedResource) GetKey

func (lr *LockedResource) GetKey() string

GetKey returns a unique key from a locked reosurce, the key is the concatenation of apiVersion/kind/namespace/name

type Set

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

Set is the main set structure that holds all the data and methods used to working with the set.

func Difference

func Difference(set1 *Set, sets ...*Set) *Set

Difference returns a new set which contains items which are in in the first set but not in the others.

func Intersection

func Intersection(sets ...*Set) *Set

Intersection returns a new set which contains items that only exist in all given sets.

func New

func New(ts ...LockedResource) *Set

New creates and initializes a new Set.

func NewWithSize

func NewWithSize(size int) *Set

NewWithSize creates a new Set and gives make map a size hint.

func SymmetricDifference

func SymmetricDifference(s *Set, t *Set) *Set

SymmetricDifference returns a new set which s is the difference of items which are in one of either, but not in both.

func Union

func Union(sets ...*Set) *Set

Union is the merger of multiple sets. It returns a new set with all the elements present in all the sets that are passed.

func (*Set) Add

func (s *Set) Add(items ...LockedResource)

Add includes the specified items (one or more) to the Set. The underlying Set s is modified. If passed nothing it silently returns.

func (*Set) Clear

func (s *Set) Clear()

Clear removes all items from the Set.

func (*Set) Copy

func (s *Set) Copy() *Set

Copy returns a new Set with a copy of s.

func (*Set) Each

func (s *Set) Each(f func(item LockedResource) bool)

Each traverses the items in the Set, calling the provided function for each Set member. Traversal will continue until all items in the Set have been visited, or if the closure returns false.

func (*Set) Has

func (s *Set) Has(items ...LockedResource) bool

Has looks for the existence of items passed. It returns false if nothing is passed. For multiple items it returns true only if all of the items exist.

func (*Set) HasAny

func (s *Set) HasAny(items ...LockedResource) bool

HasAny looks for the existence of any of the items passed. It returns false if nothing is passed. For multiple items it returns true if any of the items exist.

func (*Set) IsEmpty

func (s *Set) IsEmpty() bool

IsEmpty reports whether the Set is empty.

func (*Set) IsEqual

func (s *Set) IsEqual(t *Set) bool

IsEqual test whether s and t are the same in size and have the same items.

func (*Set) IsSubset

func (s *Set) IsSubset(t *Set) bool

IsSubset tests whether t is a subset of s.

func (*Set) IsSuperset

func (s *Set) IsSuperset(t *Set) bool

IsSuperset tests whether t is a superset of s.

func (*Set) List

func (s *Set) List() []LockedResource

List returns a slice of all items. There is also StringSlice() and IntSlice() methods for returning slices of type string or int.

func (*Set) Merge

func (s *Set) Merge(t *Set)

Merge is like Union, however it modifies the current Set it's applied on with the given t Set.

func (*Set) Pop

func (s *Set) Pop() LockedResource

Pop deletes and returns an item from the Set. The underlying Set s is modified. If Set is empty, the zero value is returned.

func (*Set) Pop2

func (s *Set) Pop2() (LockedResource, bool)

Pop2 tries to delete and return an item from the Set. The underlying Set s is modified. The second value is a bool that is true if the item existed in the set, and false if not. If Set is empty, the zero value and false are returned.

func (*Set) Remove

func (s *Set) Remove(items ...LockedResource)

Remove deletes the specified items from the Set. The underlying Set s is modified. If passed nothing it silently returns.

func (*Set) Separate

func (s *Set) Separate(t *Set)

Separate removes the Set items containing in t from Set s. Please aware that it's not the opposite of Merge.

func (*Set) Size

func (s *Set) Size() int

Size returns the number of items in a Set.

func (*Set) String

func (s *Set) String() string

String returns a string representation of s