Merge pull request #100 from dax/add-mockserver-reset

feat: Add MockServer reset function

src/api/server.rs

@@ -272,6 +272,48 @@ impl MockServer {
             server: self,
         }
     }
+
+    /// Delete all [Mock](struct.Mock.html) object on the mock server and their call history.
+    ///
+    /// **Example**:
+    /// ```
+    /// use isahc::get;
+    ///
+    /// let server = httpmock::MockServer::start();
+    ///
+    /// let mock = server.mock(|when, then| {
+    ///     when.path("/hello");
+    ///     then.status(200);
+    /// });
+    ///
+    /// get(server.url("/hello")).unwrap();
+    ///
+    /// mock.assert();
+    ///
+    /// ...
+    ///
+    /// server.reset().await;
+    ///
+    /// let mock = server.mock(|when, then| {
+    ///     when.path("/hello");
+    ///     then.status(404);
+    /// });
+    ///
+    /// // This will now return a 404
+    /// get(server.url("/hello")).unwrap();
+    ///
+    /// mock.assert();
+    /// ```
+    pub async fn reset(&self) {
+        if let Some(server_adapter) = &self.server_adapter {
+            with_retry(5, || server_adapter.delete_all_mocks())
+                .await
+                .expect("Cannot reset mock server (task: delete mocks).");
+            with_retry(5, || server_adapter.delete_history())
+                .await
+                .expect("Cannot reset mock server (task: delete request history).");
+        }
+    }
 }
 
 impl Drop for MockServer {

tests/examples/getting_started_tests.rs

@@ -50,3 +50,42 @@ async fn async_getting_started_test() {
     // Ensure the mock server did respond as specified above.
     assert_eq!(response.status(), 200);
 }
+
+#[async_std::test]
+async fn reset_test() {
+    // Start a lightweight mock server.
+    let server = MockServer::start();
+
+    // Create a mock on the server that will be reset later
+    server.mock(|when, then| {
+        when.method("GET")
+            .path("/translate")
+            .query_param("word", "hello");
+        then.status(500)
+            .header("content-type", "text/html; charset=UTF-8")
+            .body("Привет");
+    });
+
+    // Delete all previously created mocks
+    server.reset().await;
+
+    // Create a new mock that will replace the previous one
+    let hello_mock = server.mock(|when, then| {
+        when.method("GET")
+            .path("/translate")
+            .query_param("word", "hello");
+        then.status(200)
+            .header("content-type", "text/html; charset=UTF-8")
+            .body("Привет");
+    });
+
+    // Send an HTTP request to the mock server. This simulates your code.
+    let response = get(server.url("/translate?word=hello")).unwrap();
+
+    // Ensure the specified mock was called.
+    hello_mock.assert();
+
+    // Ensure the mock server did respond as specified.
+    assert_eq!(response.status(), 200);
+}
+