Struct CuContext 

pub struct CuContext {
    pub clock: RobotClock,
    /* private fields */
}

Execution context passed to task and bridge callbacks.

CuContext provides callback code with:

• time access through clock and Deref<Target = RobotClock>
• current execution sequence id via cl_id()
• current task metadata via task_id() / task_index()

The execution sequence id matches the copper-list id of the iteration being processed. It is also available in other lifecycle callbacks (start/preprocess/postprocess/stop) for continuity, but outside process callbacks it must not be treated as a live copper-list handle.

The runtime creates one context per execution loop and updates transient fields such as the currently executing task before each callback.

Fields

clock: RobotClock

Runtime clock. Kept as a field for direct access (context.clock.now()).

Implementations

impl CuContext

pub fn builder(clock: RobotClock) -> CuContextBuilder

Starts a context builder from a clock.

pub fn from_clock(clock: RobotClock) -> Self

Creates a context from an existing clock with default metadata.

Defaults:

• cl_id = 0
• no task id table

pub fn new_with_clock() -> Self

Creates a context backed by a real robot clock.

Defaults:

• cl_id = 0
• no task id table

pub fn new_mock_clock() -> (Self, RobotClockMock)

Creates a context backed by a mock clock.

Returns both the context and its [RobotClockMock] control handle.

pub fn set_current_task(&mut self, task_index: usize)

Sets the currently executing task index.

pub fn clear_current_task(&mut self)

Clears the currently executing task.

pub fn cl_id(&self) -> u64

Returns the current execution sequence id.

In process callbacks, this value is the id of the copper-list being processed. In other lifecycle callbacks, this value is still meaningful for sequencing but does not imply that a copper-list instance is alive.

pub fn task_index(&self) -> Option<usize>

Returns the current task index, if any.

pub fn task_id(&self) -> Option<&'static str>

Returns the current task id, if any.

Methods from Deref<Target = RobotClock>

pub fn now(&self) -> CuDuration

Now returns the time that passed since the reference time, usually the start time. It is a monotonically increasing value.

pub fn recent(&self) -> CuDuration

A less precise but quicker time

Trait Implementations

impl Clone for CuContext

fn clone(&self) -> CuContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CuContext

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

Formats the value using the given formatter.

impl Deref for CuContext

type Target = RobotClock

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.