Struct bdrck::testing::http::TestStubClient

pub struct TestStubClient { /* fields omitted */ }

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.

Methods

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.