Struct ChildTestHarness 

pub struct ChildTestHarness<C: Child> { /* private fields */ }

Test harness for Child trait implementations.

Provides signal handling and status testing for any Child. For testing run(), use SyncChildTestHarness or AsyncChildTestHarness.

Example

use orcs_component::testing::ChildTestHarness;
use orcs_component::{Child, Identifiable, SignalReceiver, Statusable, Status};
use orcs_event::{Signal, SignalResponse};

struct PassiveChild {
    id: String,
    status: Status,
}

impl Identifiable for PassiveChild {
    fn id(&self) -> &str { &self.id }
}

impl SignalReceiver for PassiveChild {
    fn on_signal(&mut self, signal: &Signal) -> SignalResponse {
        if signal.is_veto() {
            self.abort();
            SignalResponse::Abort
        } else {
            SignalResponse::Handled
        }
    }
    fn abort(&mut self) { self.status = Status::Aborted; }
}

impl Statusable for PassiveChild {
    fn status(&self) -> Status { self.status }
}

impl Child for PassiveChild {}

let child = PassiveChild { id: "test".into(), status: Status::Idle };
let mut harness = ChildTestHarness::new(child);

assert_eq!(harness.status(), Status::Idle);
harness.veto();
assert_eq!(harness.status(), Status::Aborted);

Implementations

impl<C: Child> ChildTestHarness<C>

pub fn new(child: C) -> Self

Creates a new test harness for the given child.

pub fn child(&self) -> &C

Returns a reference to the child under test.

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

Returns a mutable reference to the child under test.

pub fn id(&self) -> &str

Returns the child’s ID.

pub fn status(&self) -> Status

Returns the current status of the child.

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

Sends a signal to the child and logs the response.

pub fn veto(&mut self) -> SignalResponse

Sends a Veto signal to the child.

pub fn cancel(&mut self) -> SignalResponse

Sends a Cancel signal to the child.

pub fn abort(&mut self)

Calls abort() on the child.

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

Returns the signal log for snapshot testing.

pub fn clear_logs(&mut self)

Clears all logs.