Struct bdrck::testing::http::TestStubClient

pub struct TestStubClient { /* private fields */ }

TestStubClient provides an HTTP-client-like interface for unit testing. Instead of interacting with real servers, it loads a previously recorded HTTP session and verifies application behavior against it.

Implementations

impl TestStubClient

pub fn new() -> Self

Create a new, empty test stub client.

pub fn push_recording(&self, recording: &[u8]) -> Result<&Self>

Push the given recording (the serialized bytes) into this test stub.

Trait Implementations

impl AbstractClient for TestStubClient

fn execute(&self, request: Request) -> Result<(ResponseMetadata, Vec<u8>)>

Execute (send) a previously-constructed HTTP request.

fn get(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP GET request.

fn post(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP POST request.

fn put(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP PUT request.

fn patch(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP PATCH request.

fn delete(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP DELETE request.

fn head(&self, url: Url) -> RequestBuilder

Returns a builder for an HTTP HEAD request.

fn sleep(&self, sleep: fn(_: Duration), duration: Duration)

This function calls the given custom sleep function with the given Duration. This can be overridden by a trait implementor to add extra logic, if needed.

fn execute_with_retries( &self, max_retries: usize, add_jitter: bool, method: Method, url: Url, headers: Option<&HeaderMap>, body: Option<&[u8]> ) -> Result<(ResponseMetadata, Vec<u8>)>

Execute (send) a previously-constructed HTTP request. In the case of a retryable failure (a 5xx error), we’ll retry up to max_retries with exponential backoff between each attempt.

fn execute_with_retries_custom_sleep( &self, sleep: fn(_: Duration), max_retries: usize, add_jitter: bool, method: Method, url: Url, headers: Option<&HeaderMap>, body: Option<&[u8]> ) -> Result<(ResponseMetadata, Vec<u8>)>

This is the same as execute_with_retries, but you can specify a custom sleep function (as opposed to std::thread::sleep).

impl Drop for TestStubClient

fn drop(&mut self)

Executes the destructor for this type.