resid

Documentation

Index

• Constants
• func ParseGroupVersion(apiVersion string) (group, version string)
• type Gvk
  • func FromKind(k string) Gvk
  • func GvkFromString(s string) Gvk
  • func (x Gvk) Equals(o Gvk) bool
  • func (x Gvk) IsLessThan(o Gvk) bool
  • func (x Gvk) IsNamespaceableKind() bool
  • func (x Gvk) IsSelected(selector *Gvk) bool
  • func (x Gvk) String() string
  • func (x Gvk) StringWoEmptyField() string
• type ResId
  • func FromString(s string) ResId
  • func NewResId(k Gvk, n string) ResId
  • func NewResIdKindOnly(k string, n string) ResId
  • func NewResIdWithNamespace(k Gvk, n, ns string) ResId
  • func (id ResId) EffectiveNamespace() string
  • func (id ResId) Equals(o ResId) bool
  • func (id ResId) GvknEquals(o ResId) bool
  • func (id ResId) GvknString() string
  • func (id ResId) IsInDefaultNs() bool
  • func (id ResId) IsNsEquals(o ResId) bool
  • func (id ResId) String() string

Constants

const (
	TotallyNotANamespace = "_non_namespaceable_"
	DefaultNamespace     = "default"
)

Functions

func ParseGroupVersion

func ParseGroupVersion(apiVersion string) (group, version string)

ParseGroupVersion parses a KRM metadata apiVersion field.

Types

type Gvk

type Gvk struct {
	Group   string `json:"group,omitempty" yaml:"group,omitempty"`
	Version string `json:"version,omitempty" yaml:"version,omitempty"`
	Kind    string `json:"kind,omitempty" yaml:"kind,omitempty"`
}

Gvk identifies a Kubernetes API type. https://github.com/kubernetes/community/blob/master/contributors/design-proposals/api-machinery/api-group.md

func FromKind

func FromKind(k string) Gvk

FromKind makes a Gvk with only the kind specified.

func GvkFromString

func GvkFromString(s string) Gvk

GvkFromString makes a Gvk from the output of Gvk.String().

func (Gvk) Equals

func (x Gvk) Equals(o Gvk) bool

Equals returns true if the Gvk's have equal fields.

func (Gvk) IsLessThan

func (x Gvk) IsLessThan(o Gvk) bool

IsLessThan returns true if self is less than the argument.

func (Gvk) IsNamespaceableKind

func (x Gvk) IsNamespaceableKind() bool

IsNamespaceableKind returns true if x is a namespaceable Gvk Implements https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/#not-all-objects-are-in-a-namespace

func (Gvk) IsSelected

func (x Gvk) IsSelected(selector *Gvk) bool

IsSelected returns true if `selector` selects `x`; otherwise, false. If `selector` and `x` are the same, return true. If `selector` is nil, it is considered a wildcard match, returning true. If selector fields are empty, they are considered wildcards matching anything in the corresponding fields, e.g.

this item:

<Group: "extensions", Version: "v1beta1", Kind: "Deployment">

is selected by

<Group: "",           Version: "",        Kind: "Deployment">

but rejected by

<Group: "apps",       Version: "",        Kind: "Deployment">

func (Gvk) String

func (x Gvk) String() string

String returns a string representation of the GVK.

func (Gvk) StringWoEmptyField

func (x Gvk) StringWoEmptyField() string

StringWoEmptyField returns a string representation of the GVK. Non-exist fields will be omitted.

type ResId

type ResId struct {
	// Gvk of the resource.
	Gvk `json:",inline,omitempty" yaml:",inline,omitempty"`

	// Name of the resource before transformation.
	Name string `json:"name,omitempty" yaml:"name,omitempty"`

	// Namespace the resource belongs to.
	// An untransformed resource has no namespace.
	// A fully transformed resource has the namespace
	// from the top most overlay.
	Namespace string `json:"namespace,omitempty" yaml:"namespace,omitempty"`
}

ResId is an identifier of a k8s resource object.

func FromString

func FromString(s string) ResId

func NewResId

func NewResId(k Gvk, n string) ResId

NewResId creates new ResId.

func NewResIdKindOnly

func NewResIdKindOnly(k string, n string) ResId

NewResIdKindOnly creates a new ResId.

func NewResIdWithNamespace

func NewResIdWithNamespace(k Gvk, n, ns string) ResId

NewResIdWithNamespace creates new ResId in a given namespace.

func (ResId) EffectiveNamespace

func (id ResId) EffectiveNamespace() string

EffectiveNamespace returns a non-ambiguous, non-empty namespace for use in reporting and equality tests.

func (ResId) Equals

func (id ResId) Equals(o ResId) bool

Equals returns true if the other id matches namespace/Group/Version/Kind/name.

func (ResId) GvknEquals

func (id ResId) GvknEquals(o ResId) bool

GvknEquals returns true if the other id matches Group/Version/Kind/name.

func (ResId) GvknString

func (id ResId) GvknString() string

GvknString of ResId based on GVK and name

func (ResId) IsInDefaultNs

func (id ResId) IsInDefaultNs() bool

IsInDefaultNs returns true if id is a namespaceable ResId and the Namespace is either not set or set to DefaultNamespace.

func (ResId) IsNsEquals

func (id ResId) IsNsEquals(o ResId) bool

IsNsEquals returns true if the id is in the same effective namespace.

func (ResId) String

func (id ResId) String() string

String of ResId based on GVK, name and prefix