10 releases

0.3.1 Nov 14, 2023
0.3.0 Mar 18, 2023
0.2.2 Feb 28, 2023
0.1.4 Feb 27, 2023

#169 in HTTP client

Download history 579/week @ 2024-07-02 435/week @ 2024-07-09 532/week @ 2024-07-16 426/week @ 2024-07-23 662/week @ 2024-07-30 475/week @ 2024-08-06 505/week @ 2024-08-13 256/week @ 2024-08-20 769/week @ 2024-08-27 142/week @ 2024-09-03 249/week @ 2024-09-10 181/week @ 2024-09-17 280/week @ 2024-09-24 544/week @ 2024-10-01 105/week @ 2024-10-08 347/week @ 2024-10-15

1,279 downloads per month

MIT license

68KB
1.5K SLoC

Mock connector for hyper::Client

This crate provides a mock Connector to replace the default one when testing applications that makes HTTP calls using hyper.

Usage

# use hyper::{Body, Request};
# use mock_http_connector::{Connector, Error};
# tokio_test::block_on(async move {
// Create a mock Connector
let mut builder = Connector::builder();
builder
    .expect()
    .times(1)
    .with_uri("https://example.com/test")
    .returning("OK")?;
let connector = builder.build();

// Use it when creating the hyper Client
let client = hyper::Client::builder().build::<_, Body>(connector.clone());

// Send requests as normal
let _res = client
.request(
    Request::builder()
        .uri("https://example.com/test")
        .body("".to_string().into())?,
)
.await?;

// Check if all expectations were called the right number of times
connector.checkpoint()?;

# Ok::<_, Error>(())
# });

Reporting

In case a Request does not match any of the cases defined in the mock connector, this crate can print a report showing why each case didn't match.

For example:

--> no matching case for request
 | 
 = the incoming request did not match any know cases.
 = incoming request:
 | 
 | method:   GET
 | uri:      http://test.example/
 | headers:
 |   authorization: bearer 1234
 |   host         : test.example
 | 
--> case 0 `WithHandler`
 | 
 | method:   POST
 |           ^^^^
 | uri:      http://test.example/
 | headers:
 |   authorization: bearer 1234
 |   content-type : application/json
 |                  ^^^^^^^^^^^^^^^^
 | body:
 | > some multi-line payload
 | > on 2 lines
 |   ^^^^^^^^^^^^^^^^^^^^^^^
 | 
 = this case doesn't match the request on the following attributes:
 | - method
 | - body
 | - header `content-type`
 | 
--> case 1 `WithHandler`
 | 
 | method:   GET
 | uri:      http://test.example/some-path
 |           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 | headers:
 |   authorization: bearer 1234
 | 
 = this case doesn't match the request on the following attributes:
 | - uri
 | 

Dependencies

~5–14MB
~164K SLoC