kubernetes: github.com/meirf/kubernetes/pkg/api/meta Index | Files

package meta

import "github.com/meirf/kubernetes/pkg/api/meta"

Package meta provides functions for retrieving API metadata from objects belonging to the Kubernetes API


Package Files

doc.go interfaces.go meta.go restmapper.go

type DefaultRESTMapper Uses

type DefaultRESTMapper struct {
    // contains filtered or unexported fields

DefaultRESTMapper exposes mappings between the types defined in a runtime.Scheme. It assumes that all types defined the provided scheme can be mapped with the provided MetadataAccessor and Codec interfaces.

The resource name of a Kind is defined as the lowercase, English-plural version of the Kind string in v1beta3 and onwards, and as the camelCase version of the name in v1beta1 and v1beta2. When converting from resource to Kind, the singular version of the resource name is also accepted for convenience.

TODO: Only accept plural for some operations for increased control? (`get pod bar` vs `get pods bar`)

func NewDefaultRESTMapper Uses

func NewDefaultRESTMapper(versions []string, f VersionInterfacesFunc) *DefaultRESTMapper

NewDefaultRESTMapper initializes a mapping between Kind and APIVersion to a resource name and back based on the objects in a runtime.Scheme and the Kubernetes API conventions. Takes a priority list of the versions to search when an object has no default version (set empty to return an error) and a function that retrieves the correct codec and metadata for a given version.

func (*DefaultRESTMapper) Add Uses

func (m *DefaultRESTMapper) Add(scheme *runtime.Scheme, mixedCase bool, versions ...string)

Add adds objects from a runtime.Scheme and its named versions to this map. If mixedCase is true, the legacy v1beta1/v1beta2 Kubernetes resource naming convention will be applied (camelCase vs lowercase).

func (*DefaultRESTMapper) RESTMapping Uses

func (m *DefaultRESTMapper) RESTMapping(version, kind string) (*RESTMapping, error)

RESTMapping returns a struct representing the resource path and conversion interfaces a RESTClient should use to operate on the provided version and kind. If a version is not provided, the search order provided to DefaultRESTMapper will be used to resolve which APIVersion should be used to access the named kind.

func (*DefaultRESTMapper) VersionAndKindForResource Uses

func (m *DefaultRESTMapper) VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)

VersionAndKindForResource implements RESTMapper

type Interface Uses

type Interface interface {
    Namespace() string
    SetNamespace(namespace string)
    Name() string
    SetName(name string)
    UID() string
    SetUID(uid string)
    APIVersion() string
    SetAPIVersion(version string)
    Kind() string
    SetKind(kind string)
    ResourceVersion() string
    SetResourceVersion(version string)
    SelfLink() string
    SetSelfLink(selfLink string)

Interface lets you work with object and list metadata from any of the versioned or internal API objects. Attempting to set or retrieve a field on an object that does not support that field (Name, UID, Namespace on lists) will be a no-op and return a default value.

func Accessor Uses

func Accessor(obj interface{}) (Interface, error)

Accessor takes an arbitary object pointer and returns meta.Interface. obj must be a pointer to an API type. An error is returned if the minimum required fields are missing. Fields that are not required return the default value and are a no-op if set. TODO: add a fast path for *TypeMeta and *ObjectMeta for internal objects

type MetadataAccessor Uses

type MetadataAccessor interface {
    APIVersion(obj runtime.Object) (string, error)
    SetAPIVersion(obj runtime.Object, version string) error

    Kind(obj runtime.Object) (string, error)
    SetKind(obj runtime.Object, kind string) error

    Namespace(obj runtime.Object) (string, error)
    SetNamespace(obj runtime.Object, namespace string) error

    Name(obj runtime.Object) (string, error)
    SetName(obj runtime.Object, name string) error

    UID(obj runtime.Object) (string, error)
    SetUID(obj runtime.Object, uid string) error

    SelfLink(obj runtime.Object) (string, error)
    SetSelfLink(obj runtime.Object, selfLink string) error


MetadataAccessor lets you work with object and list metadata from any of the versioned or internal API objects. Attempting to set or retrieve a field on an object that does not support that field (Name, UID, Namespace on lists) will be a no-op and return a default value.

MetadataAccessor exposes Interface in a way that can be used with multiple objects.

func NewAccessor Uses

func NewAccessor() MetadataAccessor

NewAccessor returns a MetadataAccessor that can retrieve or manipulate resource version on objects derived from core API metadata concepts.

type RESTMapper Uses

type RESTMapper interface {
    VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)
    RESTMapping(version, kind string) (*RESTMapping, error)

RESTMapper allows clients to map resources to kind, and map kind and version to interfaces for manipulating those objects. It is primarily intended for consumers of Kubernetes compatible REST APIs as defined in docs/api-conventions.md.

type RESTMapping Uses

type RESTMapping struct {
    // Resource is a string representing the name of this resource as a REST client would see it
    Resource string
    // APIVersion represents the APIVersion that represents the resource as presented. It is provided
    // for convenience for passing around a consistent mapping.
    APIVersion string
    Kind       string


RESTMapping contains the information needed to deal with objects of a specific resource and kind in a RESTful manner.

type VersionInterfaces Uses

type VersionInterfaces struct {

VersionInterfaces contains the interfaces one should use for dealing with types of a particular version.

type VersionInterfacesFunc Uses

type VersionInterfacesFunc func(apiVersion string) (*VersionInterfaces, bool)

VersionInterfacesFunc returns the appropriate codec, typer, and metadata accessor for a given api version, or false if no such api version exists.

Package meta imports 5 packages (graph). Updated 2017-11-29. Refresh now. Tools for package owners.