Struct TestHost 

pub struct TestHost<S: SourceManager = DefaultSourceManager> {
    pub event_handler: Vec<u32>,
    pub debug_handler: Vec<String>,
    pub source_manager: Arc<S>,
    /* private fields */
}

A unified testing host that combines trace collection, event handling, debug handling, and process state consistency checking.

Fields

event_handler: Vec<u32>

List of event IDs that have been received

debug_handler: Vec<String>

List of debug command strings that have been received

source_manager: Arc<S>

Source manager for debugging information

Implementations

impl TestHost

pub fn new() -> Self

Creates a new TestHost with minimal functionality for basic testing.

pub fn with_kernel_forest(kernel_forest: Arc<MastForest>) -> Self

Creates a new TestHost with a kernel forest for full consistency testing.

pub fn get_trace_count(&self, trace_id: u32) -> u32

Gets the count of executions for a specific trace ID.

pub fn get_execution_order(&self) -> &[(u32, u64)]

Gets the execution order as a reference (with clock cycles).

pub fn snapshots(&self) -> &BTreeMap<u32, Vec<ProcessorStateSnapshot>>

Gets mutable access to all snapshots.

Trait Implementations

impl<S> BaseHost for TestHost<S>

where S: SourceManagerSync,

fn get_label_and_source_file( &self, location: &Location, ) -> (SourceSpan, Option<Arc<SourceFile>>)

Returns the [SourceSpan] and optional [SourceFile] for the provided location.

fn on_debug( &mut self, _process: &ProcessorState<'_>, options: &DebugOptions, ) -> Result<(), DebugError>

Handles the debug request from the VM.

fn on_trace( &mut self, process: &ProcessorState<'_>, trace_id: u32, ) -> Result<(), TraceError>

Handles the trace emitted from the VM.

fn resolve_event(&self, _event_id: EventId) -> Option<&EventName>

Returns the EventName registered for the provided EventId, if any.

impl<S: Clone + SourceManager> Clone for TestHost<S>

fn clone(&self) -> TestHost<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + SourceManager> Debug for TestHost<S>

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

Formats the value using the given formatter.

impl Default for TestHost

fn default() -> Self

Returns the “default value” for a type.

impl<S> SyncHost for TestHost<S>

where S: SourceManagerSync,

fn get_mast_forest(&self, node_digest: &Word) -> Option<Arc<MastForest>>

Returns MAST forest corresponding to the specified digest, or None if the MAST forest for this digest could not be found in this host.

fn on_event( &mut self, process: &ProcessorState<'_>, ) -> Result<Vec<AdviceMutation>, EventError>

Handles the event emitted from the VM and provides advice mutations to be applied to the advice provider.