Struct DedicatedExecutor 

pub struct DedicatedExecutor { /* private fields */ }

A long-lived handle to one dedicated session: every future spawned on it runs on that session’s single thread, never on the background pool.

Use this when tasks rely on thread-local state being coherent across spawns, or when the per-thread setup cost of the work is high enough that it should be paid once. Creating the session costs a thread (on the web, a worker — expensive); each spawn afterwards is just a channel send.

Dropping the handle cancels the session: queued and future spawns resolve to cancelled tasks.

Implementations

impl DedicatedExecutor

pub fn new(executor: &BackgroundExecutor) -> DedicatedExecutor

Starts a dedicated session on executor and returns a handle that spawns futures onto it. Under TestScheduler the session runs on the deterministic test loop; no real thread is created.

pub fn spawn<F>(&self, future: F) -> Task<<F as Future>::Output>

where F: Future + Send + 'static, <F as Future>::Output: Send + 'static,

Spawns a future onto the dedicated session’s thread.

The returned task has the usual semantics: dropping it cancels the future, .awaiting it yields the output, .detach()ing it lets it run to completion on its own.