Struct ChildServiceContext 

pub struct ChildServiceContext { /* private fields */ }

A sealed, cloneable descendant of a RootServiceContext.

Libraries receive this type or a capability derived from it. They cannot construct it from a Tokio handle, create a root task group, or promote it back to a root.

Implementations

impl ChildServiceContext

pub fn name(&self) -> &str

Returns the name.

pub fn task_spawner(&self) -> TaskSpawner

Returns the task spawner.

pub fn task_group(&self) -> &TaskGroup

Returns the task group.

pub fn blocking(&self, lane: BlockingLane) -> &BlockingExecutor

Returns the blocking.

pub fn storage_io(&self) -> &BlockingExecutor

Returns the storage io.

pub fn metadata_io(&self) -> &BlockingExecutor

Returns the metadata io.

pub fn cpu_crypto(&self) -> &BlockingExecutor

Returns the cpu crypto.

pub fn diagnostics(&self) -> &RuntimeDiagnostics

Returns the diagnostics.

pub fn process_budget(&self) -> ResourceBudget

Returns the shared process resource-budget root.

pub fn resources(&self) -> &RuntimeResources

Returns the process-wide runtime resource capabilities.

pub fn diagnostics_snapshot(&self) -> RuntimeDiagnosticsSnapshot

Returns the diagnostics snapshot.

pub fn diagnostics_view_v1( &self, component: RuntimeComponent, ) -> RuntimeDiagnosticsViewV1

Returns a bounded, sanitized diagnostics view for this service subtree.

pub fn diagnostics_view_v2( &self, component: RuntimeComponent, inputs: RuntimeDiagnosticsInputs, ) -> RuntimeDiagnosticsViewV2

Returns a bounded, explicitly scoped diagnostics view for this subtree.

The runtime context does not own scheduled groups or a metadata actor, so the caller supplies the snapshots it holds; a section without an input is reported as absent rather than as an empty value.

pub fn diagnostics_view_v2_with_options( &self, component: RuntimeComponent, inputs: RuntimeDiagnosticsInputs, options: RuntimeDiagnosticsViewOptionsV2, ) -> RuntimeDiagnosticsViewV2

Returns a bounded, explicitly scoped diagnostics view with explicit budget limits, including the scan and output budgets of an on-demand task detail list.

pub fn component(&self, scope: impl Into<ScopeId>) -> Self

Creates a long-lived component context owned by this service.

Dynamically supplied names must be validated with ScopeId::try_new before they reach this boundary. Static literals may use the constrained From<&'static str> conversion.

pub fn try_component(&self, scope: impl Into<ScopeId>) -> RuntimeResult<Self>

Creates an independently cancellable child component owned by this service.

Parent cancellation propagates to the returned component. Cancelling the child does not cancel this service or sibling components.

Errors

Returns an unavailable runtime failure after this service starts shutting down or becomes poisoned. Dynamically supplied names must be validated with ScopeId::try_new before this call.

pub fn scheduled_tasks(&self, scope: impl Into<ScopeId>) -> ScheduledTaskGroup

Returns the scheduled tasks.

pub fn spawn<F>( &self, name: impl Into<TaskName>, kind: TaskKind, future: F, ) -> RuntimeResult<TaskId>

where F: Future<Output = ()> + Send + 'static,

Spawns the supplied task.

pub fn spawn_service<F>( &self, name: impl Into<TaskName>, future: F, ) -> RuntimeResult<TaskId>

where F: Future<Output = ()> + Send + 'static,

Spawns a service that owns its shutdown protocol.

Use Self::spawn_cancellable_service when owner cancellation may safely drop the service future immediately.

pub fn spawn_cancellable_service<F>( &self, name: impl Into<TaskName>, future: F, ) -> RuntimeResult<TaskId>

where F: Future<Output = ()> + Send + 'static,

Spawns a service that exits when either its future completes or this context is cancelled.

Errors

Returns an error when this service context is shutting down or closed.

pub fn spawn_critical<F>( &self, name: impl Into<TaskName>, kind: TaskKind, failures: CriticalFailureState, future: F, ) -> RuntimeResult<TaskId>

where F: Future<Output = ()> + Send + 'static,

Spawns work whose panic is recorded as a critical failure.

Errors

Returns an error when this service context is shutting down or closed.

pub fn spawn_critical_service<F>( &self, name: impl Into<TaskName>, failures: CriticalFailureState, future: F, ) -> RuntimeResult<TaskId>

where F: Future<Output = ()> + Send + 'static,

Spawns a critical service that must run until this context is cancelled.

Errors

Returns an error when this service context is shutting down or closed.

Trait Implementations

impl Clone for ChildServiceContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChildServiceContext

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

Formats the value using the given formatter.