Skip to main content

Ticket

Struct Ticket 

Source
pub struct Ticket {
    answer: Receiver<Result<Outcome, Error>>,
    cancel: CancelToken,
    delivered: bool,
    segmenter: Option<JoinHandle<()>>,
}
Expand description

A transcription in flight. On the pipelined capture path this is the take’s AGGREGATE: it resolves once every segment and the tail have run and the join has been normalized once.

Fields§

§answer: Receiver<Result<Outcome, Error>>§cancel: CancelToken§delivered: bool

Set once the answer is in hand. A delivered ticket’s own drop is not an abandonment: on the direct path the diagnostics record is written after the answer goes out, and the drop’s cancel would delete the take the worker is still writing. A host’s clone from Ticket::cancel_token keeps sharing the flag, so abandoning the take after the answer still cancels it.

§segmenter: Option<JoinHandle<()>>

The take’s segmenter, on the capture path. Joined so no take thread outlives the value that owns its result; it holds no native state, so the join is tidiness and not the teardown guarantee - that is the worker join in Engine::drop.

Implementations§

Source§

impl Ticket

Source

pub fn recv(self) -> Result<Outcome, Error>

Wait for the result.

BLOCKING, and deliberately without an async twin: an async host wraps this in its own spawn_blocking, where the reverse would put a runtime in every consumer to serve one.

Source

pub fn cancel_token(&self) -> CancelToken

A clone of this ticket’s cancel token. Cancelling it aborts THIS transcription - a job still queued behind another takes the token with it and is aborted when its turn comes - which is why a host abandoning one take among several goes through here rather than through anything engine-wide.

Trait Implementations§

Source§

impl Debug for Ticket

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for Ticket

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

§

impl !RefUnwindSafe for Ticket

§

impl !Sync for Ticket

§

impl !UnwindSafe for Ticket

§

impl Freeze for Ticket

§

impl Send for Ticket

§

impl Unpin for Ticket

§

impl UnsafeUnpin for Ticket

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
§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<S> FromSample<S> for S

§

fn from_sample_(s: S) -> S

§

impl<T> Instrument for T

§

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

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

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.

§

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

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

§

fn to_sample_(self) -> U

Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

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

Source§

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.
§

impl<T> WithSubscriber for T

§

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
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

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