reqwest_mock 0.7.0

Provides a mockable reqwest-like HTTP client.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//! Defines the main types to be used to mock the HTTP client.

use config::ClientConfig;
use error::Error;
use request::Request;
use request_builder::RequestBuilder;
use reqwest::{IntoUrl, Method};
use response::Response;

/// Provides a unified interface over the different Clients.
///
/// Write your code generic over this trait and for example in testing you can use a different
/// client than in your normal library's code.
pub trait Client: Sized {
    /// Execute a request.
    ///
    /// If config is `None` the client is to use the internal config otherwise it is to use the
    /// provided config here.
    fn execute(&self, config: Option<&ClientConfig>, request: Request) -> Result<Response, Error>;

    /// Returns a immutable reference to the internal config.
    fn config(&self) -> &ClientConfig;

    /// Returns a mutable reference to the internal config.
    fn config_mut(&mut self) -> &mut ClientConfig;

    ////////////////////////////////////////////////////////

    /// Convenience method to make a `GET` request to a URL.
    fn get<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::GET, url)
    }

    /// Convenience method to make a `POST` request to a URL.
    fn post<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::POST, url)
    }

    /// Convenience method to make a `PUT` request to a URL.
    fn put<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::PUT, url)
    }

    /// Convenience method to make a `PATCH` request to a URL.
    fn patch<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::PATCH, url)
    }

    /// Convenience method to make a `DELETE` request to a URL.
    fn delete<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::DELETE, url)
    }

    /// Convenience method to make a `HEAD` request to a URL.
    fn head<'cl, U: IntoUrl>(&'cl self, url: U) -> RequestBuilder<'cl, Self> {
        self.request(Method::HEAD, url)
    }

    /// Returns a `RequestBuilder` for the given method and URL, which allows for further
    /// configuration of the request, like including additional headers, and sending it.
    fn request<'cl, U: IntoUrl>(&'cl self, method: Method, url: U) -> RequestBuilder<'cl, Self> {
        RequestBuilder::new(self, url, method)
    }
}

mod direct;
pub use self::direct::DirectClient;

mod replay;
pub use self::replay::{RecordingTarget, ReplayClient};

mod stub;
pub use self::stub::{
    RequestStubber, ResponseStubber, StubClient, StubDefault, StubSettings, StubStrictness,
};

mod generic;
pub use self::generic::GenericClient;