Struct Context 

pub struct Context {
    pub name: String,
    pub created_at: Instant,
    /* private fields */
}

Hierarchical context for task management and cancellation

Fields

name: String

Context name for debugging

created_at: Instant

When this context was created

Implementations

impl Context

pub fn new(name: &str) -> Arc<Context>

Create new root context (typically only used by main macro)

pub fn child(&self, name: &str) -> ContextBuilder

Create child context

pub fn spawn<F>(&self, task: F) -> JoinHandle<F::Output>

where F: Future + Send + 'static, F::Output: Send + 'static,

Simple spawn (inherits current context, no child creation)

pub fn spawn_child<F, Fut>( &self, name: &str, task: F, ) -> JoinHandle<Fut::Output>

where F: FnOnce(Arc<Context>) -> Fut + Send + 'static, Fut: Future + Send + 'static, Fut::Output: Send + 'static,

Spawn task with named child context (common case shortcut)

pub async fn wait(&self)

Wait for cancellation signal (for use in tokio::select!)

pub fn cancelled(&self) -> WaitForCancellationFuture<'_>

Wait for cancellation signal (returns proper Future for tokio::select!)

pub fn is_cancelled(&self) -> bool

Check if this context is cancelled

pub fn cancel(&self)

Cancel this context and all children recursively

pub fn persist(&self)

Mark this context for persistence (distributed tracing)

pub fn status(&self) -> ContextStatus

Get status information for this context and all children

Trait Implementations

impl Clone for Context

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.