Feature for API retrieve

.gitignore

@@ -3,3 +3,5 @@ AUTHORS
 ChangeLog
 *.egg-info
 .eggs
+
+.idea/

mockserver_friendly/__init__.py

@@ -1,9 +1,23 @@
 import collections
 import json
+from enum import Enum
 
 import requests
 
 
+class RetrievedObjects(Enum):
+    logs = 'logs'
+    requests = 'requests'
+    recorded_expectations = 'recorded_expectations'
+    active_expectations = 'active_expectations'
+
+
+class RetrievedFormat(Enum):
+    java = 'java'
+    json = 'json'
+    log_entries = 'log_entries'
+
+
 class MockServerFriendlyClient(object):
     def __init__(self, base_url):
         self.base_url = base_url
@@ -24,7 +38,7 @@ def stub(self, request, response, timing=None, time_to_live=None):
             _Option("timeToLive", time_to_live, formatter=_to_time_to_live)
         )))
 
-    def expect(self, request, response, timing, time_to_live=None):
+    def expect(self, request, response, timing=None, time_to_live=None):
         self.stub(request, response, timing, time_to_live)
         self.expectations.append((request, timing))
 
@@ -36,6 +50,23 @@ def verify(self):
             }))
             assert result.status_code == 202, result.content.decode('UTF-8').replace('\n', '\r\n')
 
+    def retrieve(self, obj_type, response_format, body):
+        """
+        Retrieve different objects from the mock server
+
+        :param obj_type: see `RetrievedObjects`
+        :param response_format: see `RetrievedFormat`
+        :param body: dict, pass params here, like: ```{"path": "/some/path"}```
+        :return: Response from the `requests`
+        """
+        return self._call(
+            command='retrieve?type={obj_type}&format={response_format}'.format(
+                obj_type=obj_type,
+                response_format=response_format
+            ),
+            data=json.dumps(body)
+        )
+
 
 def request(method=None, path=None, querystring=None, body=None, headers=None, cookies=None):
     return _non_null_options_to_dict(