Struct kube_runtime::reflector::store::Store

source ·
pub struct Store<K: 'static + Lookup>
where K::DynamicType: Hash + Eq,
{ /* private fields */ }
Expand description

A readable cache of Kubernetes objects of kind K

Cloning will produce a new reference to the same backing store.

Cannot be constructed directly since one writer handle is required, use Writer::as_reader() instead.

Implementations§

source§

impl<K: 'static + Clone + Lookup> Store<K>
where K::DynamicType: Eq + Hash + Clone,

source

pub async fn wait_until_ready(&self) -> Result<(), WriterDropped>

Wait for the store to be populated by Kubernetes.

Note that polling this will not await the source of the stream that populates the Writer. The reflector stream must be awaited separately.

§Errors

Returns an error if the Writer was dropped before any value was written.

source

pub fn get(&self, key: &ObjectRef<K>) -> Option<Arc<K>>

Retrieve a clone() of the entry referred to by key, if it is in the cache.

key.namespace is ignored for cluster-scoped resources.

Note that this is a cache and may be stale. Deleted objects may still exist in the cache despite having been deleted in the cluster, and new objects may not yet exist in the cache. If any of these are a problem for you then you should abort your reconciler and retry later. If you use kube_rt::controller then you can do this by returning an error and specifying a reasonable error_policy.

source

pub fn state(&self) -> Vec<Arc<K>>

Return a full snapshot of the current values

source

pub fn find<P>(&self, predicate: P) -> Option<Arc<K>>
where P: Fn(&K) -> bool,

Retrieve a clone() of the entry found by the given predicate

source

pub fn len(&self) -> usize

Return the number of elements in the store

source

pub fn is_empty(&self) -> bool

Return whether the store is empty

Trait Implementations§

source§

impl<K> Clone for Store<K>
where K::DynamicType: Hash + Eq, K: Clone + 'static + Lookup,

source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<K> Debug for Store<K>
where K::DynamicType: Hash + Eq + Debug, K: Debug + 'static + Lookup,

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<K> Freeze for Store<K>

§

impl<K> !RefUnwindSafe for Store<K>

§

impl<K> Send for Store<K>
where <K as Lookup>::DynamicType: Send + Sync, K: Sync + Send,

§

impl<K> Sync for Store<K>
where <K as Lookup>::DynamicType: Send + Sync, K: Sync + Send,

§

impl<K> Unpin for Store<K>

§

impl<K> !UnwindSafe for Store<K>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> DynClone for T
where T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more