0.32.0

This is a major re-write, introducing a bunch of long awaited features:

• [Breaking] The minimum supported Rust version was bumped to 1.65.0

• Tests can now run in parallel as long as you use the new mockito::Server API:

  let mut server = mockito::Server::new();
  let mock = server.mock("GET", "/").with_body("test").create();
  
  // Use one of these to configure your client
  let host = server.host_with_port();
  let url = server.url();

• You can run multiple servers/hosts at the same time:

  let mut twitter = mockito::Server::new();
  let twitter_mock = server.mock("GET", "/api").with_body("tweet").create();
  let twitter_host = twitter.host_with_port();
  
  let mut github = mockito::Server::new();
  let github_mock = server.mock("GET", "/api").with_body("repo").create();
  let github_host = github.host_with_port();

• Support for HTTP2

• An async interface for all actions (though the sync interface is also available):

  let mut server = Server::new_async().await;
  let mock = s
      .mock("GET", "/hello")
      .with_body("world")
      .create_async()
      .await;
  
  mock.assert_async().await;

• The backend has been rewritten to use Hyper

This version will be backwards compatible with the previous version, but deprecation warnings have been introduced and you are encouraged to migrate, since the old API still requires running tests sequentially. Migrating to the new API is quite straighforward:

Migrating to the new API

Legacy API:

let m = mockito::mock("GET", "/").with_body("hello").create();

// Use one of these to configure your client
let host = mockito:server_address();
let url = mockito::server_url();

New API:

let mut server = mockito::Server::new();
let m = sever.mock("GET", "/").with_body("hello").create();

// Use one of these to configure your client
let host = server.host_with_port();
let url = server.url();

Migrating to the async API

In order to write async tests, you'll need to use the _async methods:

• Server::new_async
• Mock::create_async
• Mock::assert_async
• Mock::matched_async
• Server::reset_async

...otherwise your tests will not compile and you'll see this error: Cannot start a runtime from within a runtime.

When using tokio, prefer the single-threaded runtime over the multi-threaded one.

Example:

#[tokio::test]
async fn test_simple_route_mock_async() {
    let mut server = Server::new_async().await;
    let m1 = server.mock("GET", "/a").with_body("aaa").create_async().await;
    let m2 = server.mock("GET", "/b").with_body("bbb").create_async().await;

    let (m1, m2) = futures::join!(m1, m2);

    // You can use `Mock::assert_async` to verify that your mock was called
    // m1.assert_async().await;
    // m2.assert_async().await;
}