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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

use crate::client::replay::RecordMode;
use client::{Client, Response};
use client::{DirectClient, RecordingTarget, ReplayClient, StubClient};
use config::ClientConfig;
use error::Error;
use request::Request;
use std::path::PathBuf;

enum InnerClient {
    Direct(DirectClient),
    Replay(ReplayClient),
    Stub(StubClient),
}

/// Provides an interface over the different client types which you can use in your code
/// if you want to avoid it having to be generic over the `Client` trait.
pub struct GenericClient {
    inner: InnerClient,
}

impl GenericClient {
    /// Create a `GenericClient` using `DirectClient` internally.
    pub fn direct() -> Self {
        DirectClient::new().into()
    }

    /// Create a `GenericClient` using `ReplayClient` internally, recording one single
    /// request to one single replay file. If a differing request is made, the file will be
    /// overwritten again.
    pub fn replay_file<P: Into<PathBuf>>(replay_file: P) -> Self {
        ReplayClient::new(RecordingTarget::File(replay_file.into()), RecordMode::default()).into()
    }

    /// Create a `GenericClient` using `ReplayClient` internally, recording multiple requests
    /// to a single directory. Each unique request will get its own replay file independent of
    /// other requests in the specified directory.
    pub fn replay_dir<P: Into<PathBuf>>(replay_dir: P) -> Self {
        ReplayClient::new(RecordingTarget::Dir(replay_dir.into()), RecordMode::default()).into()
    }

    /// Create a `GenericClient` using `StubClient` internally.
    pub fn stub(client: StubClient) -> Self {
        client.into()
    }

    /// If this is a ReplayClient it will inform the Replay Client that whichever next request is
    /// made should be recorded again, even if it has been made exactly this way before.
    pub fn force_record_next(&self) {
        match self.inner {
            InnerClient::Direct(_) | InnerClient::Stub(_) => {}
            InnerClient::Replay(ref replay) => replay.force_record_next(),
        }
    }

    /*
    /// Convert the current instance to a `ReplayClient` replaying the file at the provided path.
    ///
    /// This can also be used to just switch the replay file as each file is only used for one
    /// request/response pair.
    pub fn replay_file<P: Into<PathBuf>>(&mut self, path: P) {
        self.inner = InnerClient::Replay(ReplayClient::new(RecordingTarget::File(path.into())));
    }
    */
}

impl From<DirectClient> for GenericClient {
    fn from(c: DirectClient) -> Self {
        GenericClient {
            inner: InnerClient::Direct(c),
        }
    }
}

impl From<ReplayClient> for GenericClient {
    fn from(c: ReplayClient) -> Self {
        GenericClient {
            inner: InnerClient::Replay(c),
        }
    }
}

impl From<StubClient> for GenericClient {
    fn from(c: StubClient) -> Self {
        GenericClient {
            inner: InnerClient::Stub(c),
        }
    }
}

impl Client for GenericClient {
    fn execute(&self, config: Option<&ClientConfig>, request: Request) -> Result<Response, Error> {
        match self.inner {
            InnerClient::Direct(ref client) => client.execute(config, request),
            InnerClient::Replay(ref client) => client.execute(config, request),
            InnerClient::Stub(ref client) => client.execute(config, request),
        }
    }

    fn config(&self) -> &ClientConfig {
        match self.inner {
            InnerClient::Direct(ref client) => client.config(),
            InnerClient::Replay(ref client) => client.config(),
            InnerClient::Stub(ref client) => client.config(),
        }
    }

    fn config_mut(&mut self) -> &mut ClientConfig {
        match self.inner {
            InnerClient::Direct(ref mut client) => client.config_mut(),
            InnerClient::Replay(ref mut client) => client.config_mut(),
            InnerClient::Stub(ref mut client) => client.config_mut(),
        }
    }
}