pub enum Lifecycle<I> {
Persisted(I),
Processed(I),
Skipped(Skip),
Failed(Failure),
}runtime only.Expand description
Where one item got to, as its consumer states it.
§The stations are CLOSED and the info is OPEN
The four variants are the whole table, because the watermark condition MATCHES on them: a
framework that could not enumerate the stations could not decide whether an item is done. The
payload is the opposite — I is the consumer’s own detail, and a batch ack is where it earns
its keep, since one answer covers many items and per-item detail has nowhere else to go.
§No default parameter
Lifecycle<I> and never Lifecycle<I = ()>. A default would let a consumer write
Lifecycle::Processed(()) without noticing it had discarded the one slot the design gave it,
and the omission would be invisible at the call site. A consumer with nothing to say writes the
unit type on purpose.
§Zero bounds
I is bounded nowhere in this type, nowhere in Ack, and nowhere in the
transport. The single bound is at AckSender::send, the erased
boundary, and it is Any + Send + Sync — what crossing an object-safe tap costs and nothing
more. A bound written here would be paid by every consumer whether or not its info ever reached
a tap.
§Why it CLONES
One outcome can be owed to SEVERAL senders. A keyed group’s delivery answers the token of every
member that joined it — see Custody — and those answers state the same
station and the same detail, differing only in which keys each releases. So the station travels
by value to each of them, which is what Clone is here for. I: Clone is the caller’s to
satisfy and the driver’s own info type (Tally) is Copy; a one-token delivery
clones nothing.
Variants§
Persisted(I)
The item’s effect is durable in this consumer’s own store. The station a landing consumer reaches, and the one that makes a channel ack safe to release: the oneshot fires AFTER the write, never before it.
Processed(I)
The item was processed and this consumer lands nothing — a pure operator’s station.
Skipped(Skip)
The item was intentionally refused, as the operator states it. The refusal travels whole,
because Skip already carries both halves an app needs: WHY, and — where the operator could
say so — WHICH content.
Failed(Failure)
The item could not be processed. It holds the window: a failed item is named in no
Ack::released set, so the sender re-delivers it.
The failure crosses ERASED for the reason I does — one tap observes every node in the
arrangement and each carries its own Operator::Error.
Implementations§
Source§impl<I> Lifecycle<I>
impl<I> Lifecycle<I>
Sourcepub const fn is_persisted(&self) -> bool
pub const fn is_persisted(&self) -> bool
Returns true if this value is of type Persisted. Returns false otherwise
Sourcepub const fn is_processed(&self) -> bool
pub const fn is_processed(&self) -> bool
Returns true if this value is of type Processed. Returns false otherwise
Sourcepub const fn is_skipped(&self) -> bool
pub const fn is_skipped(&self) -> bool
Returns true if this value is of type Skipped. Returns false otherwise
Source§impl<I> Lifecycle<I>
impl<I> Lifecycle<I>
Sourcepub fn unwrap_persisted(self) -> I
pub fn unwrap_persisted(self) -> I
Unwraps this value to the Lifecycle::Persisted variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_persisted_ref(&self) -> &I
pub fn unwrap_persisted_ref(&self) -> &I
Unwraps this reference to the Lifecycle::Persisted variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_persisted_mut(&mut self) -> &mut I
pub fn unwrap_persisted_mut(&mut self) -> &mut I
Unwraps this mutable reference to the Lifecycle::Persisted variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_processed(self) -> I
pub fn unwrap_processed(self) -> I
Unwraps this value to the Lifecycle::Processed variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_processed_ref(&self) -> &I
pub fn unwrap_processed_ref(&self) -> &I
Unwraps this reference to the Lifecycle::Processed variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_processed_mut(&mut self) -> &mut I
pub fn unwrap_processed_mut(&mut self) -> &mut I
Unwraps this mutable reference to the Lifecycle::Processed variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_skipped(self) -> Skip
pub fn unwrap_skipped(self) -> Skip
Unwraps this value to the Lifecycle::Skipped variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_skipped_ref(&self) -> &Skip
pub fn unwrap_skipped_ref(&self) -> &Skip
Unwraps this reference to the Lifecycle::Skipped variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_skipped_mut(&mut self) -> &mut Skip
pub fn unwrap_skipped_mut(&mut self) -> &mut Skip
Unwraps this mutable reference to the Lifecycle::Skipped variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_failed(self) -> Failure
pub fn unwrap_failed(self) -> Failure
Unwraps this value to the Lifecycle::Failed variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_failed_ref(&self) -> &Failure
pub fn unwrap_failed_ref(&self) -> &Failure
Unwraps this reference to the Lifecycle::Failed variant.
Panics if this value is of any other type.
Sourcepub fn unwrap_failed_mut(&mut self) -> &mut Failure
pub fn unwrap_failed_mut(&mut self) -> &mut Failure
Unwraps this mutable reference to the Lifecycle::Failed variant.
Panics if this value is of any other type.
Source§impl<I> Lifecycle<I>
impl<I> Lifecycle<I>
Sourcepub fn try_unwrap_persisted(self) -> Result<I, TryUnwrapError<Self>>
pub fn try_unwrap_persisted(self) -> Result<I, TryUnwrapError<Self>>
Attempts to unwrap this value to the Lifecycle::Persisted variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_persisted_ref(&self) -> Result<&I, TryUnwrapError<&Self>>
pub fn try_unwrap_persisted_ref(&self) -> Result<&I, TryUnwrapError<&Self>>
Attempts to unwrap this reference to the Lifecycle::Persisted variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_persisted_mut(
&mut self,
) -> Result<&mut I, TryUnwrapError<&mut Self>>
pub fn try_unwrap_persisted_mut( &mut self, ) -> Result<&mut I, TryUnwrapError<&mut Self>>
Attempts to unwrap this mutable reference to the Lifecycle::Persisted variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_processed(self) -> Result<I, TryUnwrapError<Self>>
pub fn try_unwrap_processed(self) -> Result<I, TryUnwrapError<Self>>
Attempts to unwrap this value to the Lifecycle::Processed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_processed_ref(&self) -> Result<&I, TryUnwrapError<&Self>>
pub fn try_unwrap_processed_ref(&self) -> Result<&I, TryUnwrapError<&Self>>
Attempts to unwrap this reference to the Lifecycle::Processed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_processed_mut(
&mut self,
) -> Result<&mut I, TryUnwrapError<&mut Self>>
pub fn try_unwrap_processed_mut( &mut self, ) -> Result<&mut I, TryUnwrapError<&mut Self>>
Attempts to unwrap this mutable reference to the Lifecycle::Processed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_skipped(self) -> Result<Skip, TryUnwrapError<Self>>
pub fn try_unwrap_skipped(self) -> Result<Skip, TryUnwrapError<Self>>
Attempts to unwrap this value to the Lifecycle::Skipped variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_skipped_ref(&self) -> Result<&Skip, TryUnwrapError<&Self>>
pub fn try_unwrap_skipped_ref(&self) -> Result<&Skip, TryUnwrapError<&Self>>
Attempts to unwrap this reference to the Lifecycle::Skipped variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_skipped_mut(
&mut self,
) -> Result<&mut Skip, TryUnwrapError<&mut Self>>
pub fn try_unwrap_skipped_mut( &mut self, ) -> Result<&mut Skip, TryUnwrapError<&mut Self>>
Attempts to unwrap this mutable reference to the Lifecycle::Skipped variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_failed(self) -> Result<Failure, TryUnwrapError<Self>>
pub fn try_unwrap_failed(self) -> Result<Failure, TryUnwrapError<Self>>
Attempts to unwrap this value to the Lifecycle::Failed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_failed_ref(&self) -> Result<&Failure, TryUnwrapError<&Self>>
pub fn try_unwrap_failed_ref(&self) -> Result<&Failure, TryUnwrapError<&Self>>
Attempts to unwrap this reference to the Lifecycle::Failed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Sourcepub fn try_unwrap_failed_mut(
&mut self,
) -> Result<&mut Failure, TryUnwrapError<&mut Self>>
pub fn try_unwrap_failed_mut( &mut self, ) -> Result<&mut Failure, TryUnwrapError<&mut Self>>
Attempts to unwrap this mutable reference to the Lifecycle::Failed variant.
Returns a [TryUnwrapError] with the original value if this value is of any other type.
Trait Implementations§
Auto Trait Implementations§
impl<I> !Freeze for Lifecycle<I>
impl<I> !RefUnwindSafe for Lifecycle<I>
impl<I> !UnwindSafe for Lifecycle<I>
impl<I> Send for Lifecycle<I>where
I: Send,
impl<I> Sync for Lifecycle<I>where
I: Sync,
impl<I> Unpin for Lifecycle<I>where
I: Unpin,
impl<I> UnsafeUnpin for Lifecycle<I>where
I: UnsafeUnpin,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be
downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further
downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSend for T
impl<T> DowncastSend for T
Source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
Source§impl<T> FmtForward for T
impl<T> FmtForward for T
Source§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self to use its Binary implementation when Debug-formatted.Source§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self to use its Display implementation when
Debug-formatted.Source§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self to use its LowerExp implementation when
Debug-formatted.Source§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self to use its LowerHex implementation when
Debug-formatted.Source§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self to use its Octal implementation when Debug-formatted.Source§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self to use its Pointer implementation when
Debug-formatted.Source§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self to use its UpperExp implementation when
Debug-formatted.Source§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self to use its UpperHex implementation when
Debug-formatted.impl<T> Fruit for T
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
Source§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
Source§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self and passes that borrow into the pipe function. Read moreSource§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
Source§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
Source§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self, then passes self.as_ref() into the pipe function.Source§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self, then passes self.as_mut() into the pipe
function.Source§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self, then passes self.deref() into the pipe function.Source§impl<T> Pointable for T
impl<T> Pointable for T
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<T> Tap for T
impl<T> Tap for T
Source§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B> of a value. Read moreSource§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B> of a value. Read moreSource§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R> view of a value. Read moreSource§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R> view of a value. Read moreSource§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target of a value. Read moreSource§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap() only in debug builds, and is erased in release builds.Source§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow() only in debug builds, and is erased in release
builds.Source§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut() only in debug builds, and is erased in release
builds.Source§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref() only in debug builds, and is erased in release
builds.Source§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut() only in debug builds, and is erased in release
builds.Source§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref() only in debug builds, and is erased in release
builds.