Crate mock_http_connector
source ·Expand description
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
// 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()?;
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
|
Structs
- Builder for
Connector
- Builder for specific mock cases
- Mock connector for
hyper::Client
Enums
- Errors generated by this crate
- Diagnostic levels
- Reason for mismatch on a case
- Report if a
with
clause for a case matched with an incoming request
Traits
- Trait for values that can be transformed into
Result<Response<String>, BoxError>
- Trait for
Future
s that return a valid response forcrate::Returning
- Trait for responses matching mock cases