httpmock 0.8.3

HTTP mocking library for Rust
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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

#[test]
fn my_custom_request_matcher_test() {
    use httpmock::prelude::*;

    // Arrange
    let server = MockServer::start();

    let mock = server.mock(|when, then| {
        when.is_true(|req| req.uri().path().ends_with("Test"));
        then.status(201);
    });

    // Act: Send the HTTP request using reqwest
    let response = reqwest::blocking::get(server.url("/thisIsMyTest")).unwrap();

    // Assert
    mock.assert();
    assert_eq!(response.status(), 201);
}

#[test]
fn is_true_matcher_called_once_per_request() {
    use httpmock::prelude::*;
    use std::sync::atomic::{AtomicUsize, Ordering};
    use std::sync::Arc;

    // Arrange
    let server = MockServer::start();
    let call_count = Arc::new(AtomicUsize::new(0));
    let call_count_clone = call_count.clone();

    let mock = server.mock(|when, then| {
        when.is_true(move |_req| {
            call_count_clone.fetch_add(1, Ordering::Relaxed);
            true
        });
        then.status(200);
    });

    // Act
    let response = reqwest::blocking::get(server.url("/test")).unwrap();

    // Assert: The custom matcher should only be called once during request matching
    assert_eq!(response.status(), 200);
    assert_eq!(call_count.load(Ordering::Relaxed), 1);
    mock.assert();
}

#[test]
fn is_false_matcher_called_once_per_request() {
    use httpmock::prelude::*;
    use std::sync::atomic::{AtomicUsize, Ordering};
    use std::sync::Arc;

    // Arrange
    let server = MockServer::start();
    let call_count = Arc::new(AtomicUsize::new(0));
    let call_count_clone = call_count.clone();

    let mock = server.mock(|when, then| {
        when.is_false(move |_req| {
            call_count_clone.fetch_add(1, Ordering::Relaxed);
            false
        });
        then.status(200);
    });

    // Act
    let response = reqwest::blocking::get(server.url("/test")).unwrap();

    // Assert: The custom matcher should only be called once during request matching
    assert_eq!(response.status(), 200);
    assert_eq!(call_count.load(Ordering::Relaxed), 1);
    mock.assert();
}

#[test]
fn dynamic_responder_test() {
    use httpmock::prelude::*;
    use reqwest::blocking::Client;
    use std::sync::Mutex;

    // Arrange
    let server = MockServer::start();

    // This is our counter that will determine the response later.
    // It needs to be protected by a mutex the custom respond method
    // is called from the HTTP server thread.
    let call_count = Mutex::new(0);

    let mock = server.mock(|when, then| {
        when.method("GET")
            .is_true(|r| r.uri().path().ends_with("/hello"));
        then.respond_with(move |_req: &HttpMockRequest| {
            let mut count = call_count.lock().unwrap();
            *count += 1;

            HttpMockResponse::builder().status(200 + *count).build()
        });
    });

    // Act
    let client = Client::new();

    let response1 = client.get(server.url("/hello")).send().unwrap();
    let response2 = client.get(server.url("/hello")).send().unwrap();
    let response3 = client.get(server.url("/hello")).send().unwrap();

    // Assert
    mock.assert_calls(3);

    assert_eq!(response1.status(), 201);
    assert_eq!(response2.status(), 202);
    assert_eq!(response3.status(), 203);
}

#[test]
fn dynamic_responder_http_crate_test() {
    use httpmock::prelude::*;
    use reqwest::blocking::Client;
    use std::sync::Mutex;

    // Arrange
    let server = MockServer::start();

    // This is our counter that will determine the response later.
    // It needs to be protected by a mutex the custom respond method
    // is called from the HTTP server thread.
    let call_count = Mutex::new(0);

    let mock = server.mock(|when, then| {
        when.method("GET");
        then.respond_with(move |req: &HttpMockRequest| {
            // Convert the HttpMockRequest to a http creates Request object
            let req: http::Request<()> = req.into();

            let mut count = call_count.lock().unwrap();
            *count += 1;

            // Return a http crate Response object which will automatically be converted into
            // a HttpMockResponse internally
            http::Response::builder()
                .status(200 + *count)
                .body(req.uri().path().to_string())
                .unwrap()
                .into()
        });
    });

    // Act
    let client = Client::new();

    let response1 = client.get(server.base_url()).send().unwrap();
    let response2 = client.get(server.base_url()).send().unwrap();
    let response3 = client.get(server.base_url()).send().unwrap();

    // Assert
    mock.assert_calls(3);

    assert_eq!(response1.status(), 201);
    assert_eq!(response2.status(), 202);
    assert_eq!(response3.status(), 203);
}