Struct kube_runtime::reflector::ObjectRef

pub struct ObjectRef<K: RuntimeResource> {
    pub name: String,
    pub namespace: Option<String>,
    // some fields omitted
}

A typed and namedspaced (if relevant) reference to a Kubernetes object

K may be either the object type or ErasedResource, in which case the type is stored at runtime. Erased ObjectRefs pointing to different types are still considered different.

use kube_runtime::reflector::{ErasedResource, ObjectRef};
use k8s_openapi::api::core::v1::{ConfigMap, Secret};
assert_ne!(
    ObjectRef::<ErasedResource>::from(ObjectRef::<ConfigMap>::new("a")),
    ObjectRef::<ErasedResource>::from(ObjectRef::<Secret>::new("a")),
);

Fields

name: String

The name of the object

namespace: Option<String>

The namespace of the object

May only be None if the kind is cluster-scoped (not located in a namespace). Note that it is acceptable for an ObjectRef to a cluster-scoped resource to have a namespace. These are, however, not considered equal:

assert_ne!(ObjectRef::<ConfigMap>::new("foo"), ObjectRef::new("foo").within("bar"));

Implementations

impl<K: Resource> ObjectRef<K>

#[must_use]pub fn new(name: &str) -> Self

#[must_use]pub fn within(mut self: Self, namespace: &str) -> Self

#[must_use]pub fn from_obj(obj: &K) -> Self where
    K: Meta, 

#[must_use]pub fn from_owner_ref(
    namespace: Option<&str>,
    owner: &OwnerReference
) -> Option<Self>

Create an ObjectRef from an OwnerReference

Returns None if the types do not match.

#[must_use]pub fn into_kind_unchecked<K2: Resource>(self) -> ObjectRef<K2>

Convert into a reference to K2

Note that no checking is done on whether this conversion makes sense. For example, every Service has a corresponding Endpoints, but it wouldn't make sense to convert a Pod into a Deployment.

Trait Implementations

impl<K: RuntimeResource> Clone for ObjectRef<K>

pub fn clone(&self) -> Self

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<K: RuntimeResource> Debug for ObjectRef<K>

pub fn fmt(&self, __f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<K: RuntimeResource> Display for ObjectRef<K>

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<K: RuntimeResource> Eq for ObjectRef<K>

impl<K: Resource> From<ObjectRef<K>> for ObjectRef<ErasedResource>

pub fn from(old: ObjectRef<K>) -> Self

Performs the conversion.

impl<K: RuntimeResource> Hash for ObjectRef<K>

pub fn hash<__HK>(&self, __state: &mut __HK) where
    __HK: Hasher, 

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl<K: RuntimeResource> PartialEq<ObjectRef<K>> for ObjectRef<K>

pub fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.