Module mock_service

Some helpers to make it simpler to mock Tower services.

A MockService is a generic [tower::Service] implementation that allows intercepting requests, responding to them individually, and checking that there are no requests to be received (at least during a period of time). The MockService can be built for proptests or for normal Rust unit tests.

Example

use zebra_test::mock_service::MockService;

let mut mock_service = MockService::build().for_unit_tests();
let mut service = mock_service.clone();

let call = tokio::spawn(mock_service.clone().oneshot("hello"));

mock_service
    .expect_request("hello").await
    .respond("hi!");

mock_service.expect_no_requests().await;

let response = call
    .await
    .expect("Failed to run call on the background")
    .expect("Failed to receive response from service");

assert_eq!(response, "hi!");

Structs

• MockService
  A service implementation that allows intercepting requests for checking them.
• MockServiceBuilder
  A builder type to create a MockService.
• ResponseSender
  A helper type for responding to incoming requests.

Enums

• PanicAssertion
  Represents normal Rust assertions that panic, like assert_eq.
• PropTestAssertion
  Represents [mod@proptest] assertions that return errors, like prop_assert_eq.

Constants

• DEFAULT_MAX_REQUEST_DELAY
  The default timeout before considering a request has not been received.
• DEFAULT_PROXY_CHANNEL_SIZE 🔒
  The default size of the channel that forwards received requests.

Traits

• AssertionType 🔒
  A representation of an assertion type.
• ResponseResult
  A helper trait to improve ergonomics when sending a response.

Type Aliases

• ProxyItem 🔒
  An internal type representing the item that’s sent in the [broadcast] channel.