Struct Executor 

pub struct Executor { /* private fields */ }

The executor (design-doc §4.3). !Send — it never leaves the sim thread.

Implementations

impl Executor

pub fn spawn_named<F>( &self, fut: F, name: Option<&str>, ) -> TaskHandle<F::Output>

where F: Future + 'static,

pub fn run_until_idle(&self)

Drain the run queue to exhaustion, then return to the simulator. Port of EventLoop.run (cocotb: _event_loop.py).

pub fn cancel(&self, id: TaskId)

Cancel = drop the future (design-doc §4.6). Cleanup happens in Drop impls; there is no exception to catch.

pub fn cancel_after(&self, watermark: TaskId)

Cancel every live task with id >= watermark (the snapshot taken before the test spawned anything) — the runner uses this to kill a test’s surviving tasks at test end (design-doc §4.5).

pub fn watermark(&self) -> TaskId

Current high-water task id (snapshot before starting a test).

pub fn set_failure_sink(&self, f: Box<dyn Fn(&str)>)

pub fn live_tasks(&self) -> usize

Trait Implementations

impl Clone for Executor

fn clone(&self) -> Executor

Returns a duplicate of the value.

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

Performs copy-assignment from source.