Struct ComponentTestHarness 

pub struct ComponentTestHarness<C: Component> { /* private fields */ }

Test harness for Component implementations.

Provides a minimal testing environment for components without requiring OrcsEngine or EventBus.

Implementations

impl<C: Component> ComponentTestHarness<C>

pub fn new(component: C) -> Self

Creates a new test harness for the given component.

pub fn component(&self) -> &C

Returns a reference to the component under test.

pub fn component_mut(&mut self) -> &mut C

Returns a mutable reference to the component under test.

pub fn init(&mut self) -> Result<(), ComponentError>

Calls init() on the component with an empty config.

Errors

Returns the component’s initialization error if any.

pub fn init_with_config(&mut self, config: &Value) -> Result<(), ComponentError>

Calls init() on the component with the given config.

Errors

Returns the component’s initialization error if any.

pub fn send_request( &mut self, request: &Request, ) -> Result<Value, ComponentError>

Sends a request to the component and logs the result.

Arguments

• request - The request to send

Returns

The result of the request.

pub fn request( &mut self, category: EventCategory, operation: &str, payload: Value, ) -> Result<Value, ComponentError>

Sends a request with the given category, operation, and payload.

Convenience method that builds the request internally.

Arguments

• category - Event category
• operation - Operation name
• payload - Request payload

Returns

The result of the request.

pub fn send_signal(&mut self, signal: Signal) -> SignalResponse

Sends a signal to the component and logs the response.

Arguments

• signal - The signal to send

Returns

The component’s response to the signal.

pub fn veto(&mut self) -> SignalResponse

Sends a Veto signal to the component.

Returns

The component’s response (should be Abort).

pub fn cancel(&mut self) -> SignalResponse

Sends a Cancel signal for the test channel.

Returns

The component’s response.

pub fn cancel_channel(&mut self, channel: ChannelId) -> SignalResponse

Sends a Cancel signal for a specific channel.

Arguments

• channel - The channel to cancel

Returns

The component’s response.

pub fn approve(&mut self, approval_id: &str) -> SignalResponse

Sends an Approve signal.

Arguments

• approval_id - The approval request ID

Returns

The component’s response.

pub fn reject( &mut self, approval_id: &str, reason: Option<String>, ) -> SignalResponse

Sends a Reject signal.

Arguments

• approval_id - The approval request ID
• reason - Optional rejection reason

Returns

The component’s response.

pub fn abort(&mut self)

Calls abort() on the component.

pub fn shutdown(&mut self)

Calls shutdown() on the component.

pub fn status(&self) -> Status

Returns the current status of the component.

pub fn id(&self) -> &ComponentId

Returns the component ID.

pub fn request_log(&self) -> &[RequestRecord]

Returns the request log for snapshot testing.

pub fn signal_log(&self) -> &[SignalRecord]

Returns the signal log for snapshot testing.

pub fn clear_logs(&mut self)

Clears all logs.

pub fn test_channel(&self) -> ChannelId

Returns the test channel ID.

pub fn with_channel(self, channel: ChannelId) -> Self

Sets a custom test channel ID.