Crate mockito [−] [src]

Mockito is a library for creating HTTP mocks to be used in integration tests or for offline work. It runs an HTTP server on your local port 1234 and can register and remove mocks.

The server is run on a separate thread within the same process and will be cleaned up at the end of the run.

Getting Started

Using compiler flags, set the URL of your web client to mockito::SERVER_URL or mockito::SERVER_ADDRESS.

Example

#[cfg(test)]
use mockito;

#[cfg(not(test))]
const URL: &'static str = "https://api.twitter.com";

#[cfg(test)]
const URL: &'static str = mockito::SERVER_URL;

Then start mocking:

Example

#[cfg(test)]
mod tests {
  use mockito::mock;

  #[test]
  fn test_something() {
    mock("GET", "/hello")
      .with_status(201)
      .with_header("content-type", "text/plain")
      .with_header("x-api-key", "1234")
      .with_body("world")
      .create();

    // Any calls to GET /hello beyond this line will respond with 201, the
    // `content-type: text/plain` header and the body "world".
  }
}

Run your tests

Due to the nature of this library (all your mocks are recorded on the same server running in background), it is highly recommended that you run your tests on a single thread:

cargo test -- --test-threads=1

# Same, but using an environment variable
RUST_TEST_THREADS=1 cargo test

In some situations, when you're always testing/mocking different routes and never need to reset or override the existing mocks, you might get away with running your tests on multiple threads.

Matching by header

Mockito currently matches by method and path, but also by headers. The header field letter case is ignored.

Example

use mockito::mock;

mock("GET", "/hello")
  .match_header("content-type", "application/json")
  .with_body("{'hello': 'world'}")
  .create();

mock("GET", "/hello")
  .match_header("content-type", "text/plain")
  .with_body("world")
  .create();

// JSON requests to GET /hello will respond with JSON, while plain requests
// will respond with text.

Other header matchers

You can match a header only by its field name, by setting the Mock::match_header value to Matcher::Any.

Example

use mockito::{mock, Matcher};

mock("GET", "/hello")
 .match_header("content-type", Matcher::Any)
 .with_body("something");

// Requests containing any content-type header value will be mocked.
// Requests not containing this header will return `501 Not Implemented`.

You can mock requests that should be missing a particular header field, by setting the Mock::match_header value to Matcher::Missing.

Example

use mockito::{mock, Matcher};

mock("GET", "/hello")
  .match_header("authorization", Matcher::Missing)
  .with_body("no authorization header");

// Requests without the authorization header will be matched.
// Requests containing the authorization header will return `501 Not Implemented`.

Non-matching calls

Any calls to the Mockito server that are not matched will return 501 Not Implemented.

Cleaning up

Even though mocks are matched in reverse order (most recent one wins), in some situations it might be useful to clean up right after the test. There are multiple ways of doing this.

By using a closure:

Example

use mockito::mock;

mock("GET", "/hello")
  .with_body("world")
  .create_for(|| {
    // mock only valid for the lifetime of this closure
    // NOTE: it might still be accessible by separate threads
  });

By calling remove() on the mock:

Example

use mockito::mock;

let mut mock = mock("GET", "/hello");
mock.with_body("world").create();

// do your thing

mock.remove();

By calling reset() to remove all mocks:

Example

use mockito::reset;

reset();

Structs

Mock	Stores information about a mocked request. Should be initialized via `mockito::mock()`.

Enums

Matcher

Allows matching headers in multiple ways: matching the exact field name and value, matching only by field name or matching that the field name is not present at all.

Constants

SERVER_ADDRESS	Points to the address the mock server is running at. Can be used with `std::net::TcpStream`.
SERVER_URL	Points to the URL the mock server is running at.

Functions

mock	Initializes a mock for the provided `method` and `path`.
reset	Removes all the mocks stored on the server.
start