Enum TestError 

#[non_exhaustive]
pub enum TestError {
    Startup(Box<dyn Error + Send + Sync>),
    Subscribe(Box<dyn Error + Send + Sync>),
    NotQuiescent {
        processed: usize,
    },
    NotSettled {
        subscription: Option<String>,
        handled: usize,
        expected: usize,
        deadline: Duration,
    },
    Connect {
        broker: String,
        source: Box<dyn Error + Send + Sync>,
    },
    Publish {
        broker: String,
        source: Box<dyn Error + Send + Sync>,
    },
    ShutDown,
    Ambiguous,
    NoTransport(String),
    PausedClock,
    Encode(String),
}

An error from the test harness.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Startup(Box<dyn Error + Send + Sync>)

An on_startup or after_startup lifecycle hook failed while starting the harness.

Subscribe(Box<dyn Error + Send + Sync>)

A subscription failed to open while starting the harness.

NotQuiescent

A reaction did not settle within the step budget (a non-terminating requeue?).

Fields

processed: usize

How many deliveries were dispatched before the harness gave up.

NotSettled

A live reaction did not settle before the deadline: a subscription had not handled what was published to a destination it reads, or a redelivery that fell due, or a handler was still running.

Fields

subscription: Option<String>

The subscription still owed a delivery, or None when every subscription had handled what it was owed and a handler was still running.

handled: usize

How many deliveries that subscription had handled.

expected: usize

How many it was owed: the publishes the harness saw to it, and the redeliveries due.

deadline: Duration

The deadline the harness was started with.

Connect

A broker failed to connect while starting the harness: its in-process transition, or its connect in live mode.

Fields

broker: String

The broker’s label, or its type for unlabeled brokers.

source: Box<dyn Error + Send + Sync>

The broker’s own connect error.

Publish

A live broker refused a message the test published onto it.

Fields

broker: String

The broker’s label, or its type for unlabeled brokers.

source: Box<dyn Error + Send + Sync>

The broker’s own publish error.

ShutDown

A publish was attempted after a fail-fast failure tore the service down.

Ambiguous

An unscoped TestApp::publish is ambiguous: more than one broker is registered.

NoTransport(String)

A broker of the app has no in-process mode, so the harness cannot start the app: its type is not registered with register_testable_broker!, which is what a broker crate does under its testing feature.

In live mode it reports an injection through an untyped handle (the sole broker, broker_named) onto a broker of such a type: address it with broker instead, which publishes through the type’s default policy.

PausedClock

TestApp::start_live was called on a paused clock. A network client’s timeouts would fire at once against it, so a live test runs on the real clock.

Encode(String)

The message failed to encode for publishing.

Trait Implementations

impl Debug for TestError

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

Formats the value using the given formatter.

impl Display for TestError

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

Formats the value using the given formatter.

impl Error for TestError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.