Struct CuDebugSession 

pub struct CuDebugSession<App, P, CB, TF, S, L>
where
    P: CopperListTuple,
    S: SectionStorage,
    L: UnifiedLogWrite<S> + 'static,
{ /* private fields */ }

Implementations

impl<App, P, CB, TF, S, L> CuDebugSession<App, P, CB, TF, S, L>

where App: CuSimApplication<S, L>, L: UnifiedLogWrite<S> + 'static, S: SectionStorage, P: CopperListTuple, CB: for<'a> Fn(&'a CopperList<P>, RobotClock) -> Box<dyn for<'z> FnMut(App::Step<'z>) -> SimOverride + 'a>, TF: Fn(&CopperList<P>) -> Option<CuTime> + Clone,

pub fn from_log( log_base: &Path, app: App, robot_clock: RobotClock, clock_mock: RobotClockMock, build_callback: CB, time_of: TF, ) -> CuResult<Self>

Build a session directly from a unified log on disk (streaming index, no bulk load).

pub fn from_log_with_cache_cap( log_base: &Path, app: App, robot_clock: RobotClock, clock_mock: RobotClockMock, build_callback: CB, time_of: TF, cache_cap: usize, ) -> CuResult<Self>

Build a session directly from a log, with an explicit cache size.

pub fn goto_cl(&mut self, culistid: u64) -> CuResult<JumpOutcome>

Jump to a copperlist by id.

pub fn goto_time(&mut self, ts: CuTime) -> CuResult<JumpOutcome>

Jump to the first copperlist at or after a timestamp.

pub fn step(&mut self, delta: i32) -> CuResult<JumpOutcome>

Step relative to the current cursor. Negative values rewind via keyframe.

pub fn current_cl(&mut self) -> CuResult<Option<Arc<CopperList<P>>>>

Access the copperlist at the current cursor, if any (cloned).

pub fn cl_at(&mut self, idx: usize) -> CuResult<Option<Arc<CopperList<P>>>>

Access a copperlist by absolute index in the log (cloned).

pub fn total_entries(&self) -> usize

Total number of copperlists indexed in this session.

pub fn nearest_keyframe_culistid(&self, target_culistid: u64) -> Option<u64>

The nearest keyframe (<= target CL), if any.

pub fn section_cache_stats(&self) -> SectionCacheStats

Returns section-cache statistics for this session.

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

Current absolute cursor index, if initialized.

pub fn with_app<R>(&mut self, f: impl FnOnce(&mut App) -> R) -> R

Borrow the underlying application for inspection (e.g., task state asserts).

impl<App, P, CB, TF, S, L> CuDebugSession<App, P, CB, TF, S, L>

where App: CuSimApplication<S, L> + ReflectTaskIntrospection, L: UnifiedLogWrite<S> + 'static, S: SectionStorage, P: CopperListTuple, CB: for<'a> Fn(&'a CopperList<P>, RobotClock) -> Box<dyn for<'z> FnMut(App::Step<'z>) -> SimOverride + 'a>, TF: Fn(&CopperList<P>) -> Option<CuTime> + Clone,

pub fn reflected_task(&self, task_id: &str) -> CuResult<&dyn Reflect>

Returns a reflected view of the current task instance by task id.

pub fn reflected_task_mut( &mut self, task_id: &str, ) -> CuResult<&mut dyn Reflect>

Mutable reflected task view by task id.

pub fn dump_reflected_task(&self, task_id: &str) -> CuResult<String>

Dumps the reflected runtime state of one task.

pub fn dump_reflected_task_schemas(&self) -> String

Dumps reflected schemas registered by this application.