Trait kube_core::Resource

pub trait Resource {
    type DynamicType: Send + Sync + 'static;
    fn kind(dt: &Self::DynamicType) -> Cow<'_, str>;
    fn group(dt: &Self::DynamicType) -> Cow<'_, str>;
    fn version(dt: &Self::DynamicType) -> Cow<'_, str>;
    fn meta(&self) -> &ObjectMeta;
    fn meta_mut(&mut self) -> &mut ObjectMeta;

    fn api_version(dt: &Self::DynamicType) -> Cow<'_, str> { ... }
    fn plural(dt: &Self::DynamicType) -> Cow<'_, str> { ... }
    fn url_path(dt: &Self::DynamicType, namespace: Option<&str>) -> String { ... }
}

An accessor trait for a kubernetes Resource.

This is for a subset of Kubernetes type that do not end in List. These types, using ObjectMeta, SHOULD all have required properties:

• .metadata
• .metadata.name

And these optional properties:

• .metadata.namespace
• .metadata.resource_version

This avoids a bunch of the unnecessary unwrap mechanics for apps.

Associated Types

type DynamicType: Send + Sync + 'static

Type information for types that do not know their resource information at compile time.

Types that know their metadata at compile time should select DynamicType = (). Types that require some information at runtime should select DynamicType as type of this information.

See DynamicObject for a valid implementation of non-k8s-openapi resources.

Required methods

fn kind(dt: &Self::DynamicType) -> Cow<'_, str>

Returns kind of this object

fn group(dt: &Self::DynamicType) -> Cow<'_, str>

Returns group of this object

fn version(dt: &Self::DynamicType) -> Cow<'_, str>

Returns version of this object

fn meta(&self) -> &ObjectMeta

Metadata that all persisted resources must have

fn meta_mut(&mut self) -> &mut ObjectMeta

Metadata that all persisted resources must have

Provided methods

fn api_version(dt: &Self::DynamicType) -> Cow<'_, str>

Returns apiVersion of this object

fn plural(dt: &Self::DynamicType) -> Cow<'_, str>

Returns the plural name of the kind

This is known as the resource in apimachinery, we rename it for disambiguation. By default, we infer this name through pluralization.

The pluralization process is not recommended to be relied upon, and is only used for k8s_openapi types, where we maintain a list of special pluralisations for compatibility.

Thus when used with DynamicObject or kube-derive, we override this with correct values.

fn url_path(dt: &Self::DynamicType, namespace: Option<&str>) -> String

Creates a url path for http requests for this resource

Implementors

impl Resource for DynamicObject

type DynamicType = ApiResource

fn group(dt: &ApiResource) -> Cow<'_, str>

fn version(dt: &ApiResource) -> Cow<'_, str>

fn kind(dt: &ApiResource) -> Cow<'_, str>

fn api_version(dt: &ApiResource) -> Cow<'_, str>

fn plural(dt: &ApiResource) -> Cow<'_, str>

fn meta(&self) -> &ObjectMeta

fn meta_mut(&mut self) -> &mut ObjectMeta

impl<K> Resource for K where
    K: Metadata<Ty = ObjectMeta>, 

Implement accessor trait for any ObjectMeta-using Kubernetes Resource

type DynamicType = ()

fn kind(_: &()) -> Cow<'_, str>

fn group(_: &()) -> Cow<'_, str>

fn version(_: &()) -> Cow<'_, str>

fn api_version(_: &()) -> Cow<'_, str>

fn meta(&self) -> &ObjectMeta

fn meta_mut(&mut self) -> &mut ObjectMeta