Struct StubHttpClient 

pub struct StubHttpClient { /* private fields */ }

An HTTP client that answers from a function rather than a network.

A screen driven from a recorded payload, a robot run that must not depend on a server, a test that wants a specific failure: all of them want one thing, which is to decide what a request answers. Written as a client each time, that is the same dozen lines of body plumbing repeated — and each copy is a chance to answer differently from the real client.

let client: HttpClientRef = Arc::new(StubHttpClient::from_text(move |url| {
    Ok(fixture_for(url))
}));

Implementations

impl StubHttpClient

pub fn new( answer: impl Fn(&HttpRequest) -> Result<HttpResponse, HttpError> + Send + Sync + 'static, ) -> Self

Answers from a function of the whole request.

pub fn with_body(body: impl Into<Vec<u8>>) -> Self

Answers every request with body and a 200.

pub fn from_text( answer: impl Fn(&str) -> Result<String, HttpError> + Send + Sync + 'static, ) -> Self

Answers with text, or an error, from a function of the URL.

Trait Implementations

impl HttpClient for StubHttpClient

fn send<'a>( &'a self, request: &'a HttpRequest, _control: HttpControl, ) -> HttpFuture<'a, HttpResponse>

Sends request, resolving when the response’s status line has arrived and its body is ready to be read.

fn get_text<'a>(&'a self, url: &'a str) -> HttpFuture<'a, String>

The body of a successful GET, as text.

fn get_bytes<'a>(&'a self, url: &'a str) -> HttpFuture<'a, Vec<u8>>

The body of a successful GET.

fn download_to<'a>( &'a self, url: &'a str, target: &'a Path, control: HttpControl, ) -> HttpFuture<'a, u64>

Streams a response into target, resuming from its current length when the server supports byte ranges, and returns the file’s whole length.