mimicker 2.0.2__tar.gz → 2.0.3__tar.gz

{mimicker-2.0.2 → mimicker-2.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mimicker
-Version: 2.0.2
+Version: 2.0.3
 Summary: A lightweight HTTP mocking server for Python
 License: MIT
 Keywords: http,mocking,testing,mock-server,stubbing,ci-cd,http-server,testing-tools,stub-server,purepython
@@ -242,6 +242,33 @@ mimicker(8080).routes(
 
 ```
 
+### Dynamic Responses with `response_func`
+
+Mimicker allows dynamic responses based on the request data using `response_func`. 
+This feature enables you to build mock responses that adapt based on request parameters, headers, and body.
+
+```python
+from mimicker.mimicker import mimicker, post
+
+# Available for use with response_func:
+# kwargs.get("payload")
+# kwargs.get("headers")
+# kwargs.get("params")
+
+def custom_response(**kwargs):
+    request_payload = kwargs.get("payload")
+    return 200, {"message": f"Hello {request_payload.get('name', 'Guest')}"}
+
+mimicker(8080).routes(
+    post("/greet")
+    .response_func(custom_response)
+)
+
+# POST /greet with body {"name": "World"} -> {"message": "Hello World"}
+# POST /greet with empty body -> {"message": "Hello Guest"}
+```
+
+
 ## Available Features:
 
 * `get(path)`: Defines a `GET` endpoint.
@@ -253,6 +280,8 @@ mimicker(8080).routes(
 * `.body(content)`: Defines the response `body`.
 * `.status(code)`: Defines the response `status code`.
 * `.headers(headers)`: Defines response `headers`.
+* `.response_func(func)`: Defines a dynamic response function based on the request data.
+
 
 ## Requirements
 Mimicker supports Python 3.7 and above.

{mimicker-2.0.2 → mimicker-2.0.3}/README.md

@@ -220,6 +220,33 @@ mimicker(8080).routes(
 
 ```
 
+### Dynamic Responses with `response_func`
+
+Mimicker allows dynamic responses based on the request data using `response_func`. 
+This feature enables you to build mock responses that adapt based on request parameters, headers, and body.
+
+```python
+from mimicker.mimicker import mimicker, post
+
+# Available for use with response_func:
+# kwargs.get("payload")
+# kwargs.get("headers")
+# kwargs.get("params")
+
+def custom_response(**kwargs):
+    request_payload = kwargs.get("payload")
+    return 200, {"message": f"Hello {request_payload.get('name', 'Guest')}"}
+
+mimicker(8080).routes(
+    post("/greet")
+    .response_func(custom_response)
+)
+
+# POST /greet with body {"name": "World"} -> {"message": "Hello World"}
+# POST /greet with empty body -> {"message": "Hello Guest"}
+```
+
+
 ## Available Features:
 
 * `get(path)`: Defines a `GET` endpoint.
@@ -231,6 +258,8 @@ mimicker(8080).routes(
 * `.body(content)`: Defines the response `body`.
 * `.status(code)`: Defines the response `status code`.
 * `.headers(headers)`: Defines response `headers`.
+* `.response_func(func)`: Defines a dynamic response function based on the request data.
+
 
 ## Requirements
 Mimicker supports Python 3.7 and above.

{mimicker-2.0.2 → mimicker-2.0.3}/mimicker/handler.py

@@ -28,21 +28,22 @@ class MimickerHandler(http.server.SimpleHTTPRequestHandler):
 
     def _handle_request(self, method: str):
         request_headers = {key.lower(): value for key, value in self.headers.items()}
+        request_body = self._get_request_body()
         matched_stub, path_params = self.stub_matcher.match(
             method, self.path, request_headers=request_headers
         )
 
         if matched_stub:
-            self._send_response(matched_stub, path_params)
+            self._send_response(matched_stub, path_params, request_body, request_headers)
         else:
             self._send_404_response(method)
 
-    def _send_response(self, matched_stub: Stub, path_params: Dict[str, str]):
+    def _send_response(self, matched_stub: Stub, path_params: Dict[str, str], request_body: Any, request_headers: Dict[str, str]):
         status_code, delay, response, response_func, headers = matched_stub
         if delay > 0:
             sleep(delay)
         if response_func:
-            status_code, response = response_func()
+            status_code, response = response_func(payload=request_body, headers=request_headers, params=path_params)
 
         self.send_response(status_code)
         self._set_headers(headers)
@@ -77,3 +78,14 @@ class MimickerHandler(http.server.SimpleHTTPRequestHandler):
     def _format_response(response: dict, path_params: dict):
         return {k: (v.format(**path_params) if isinstance(v, str) else v)
                 for k, v in response.items()}
+
+    def _get_request_body(self) -> Optional[dict]:
+        content_length = self.headers.get('content-length')
+        if content_length:
+            try:
+                length = int(content_length)
+                body = self.rfile.read(length).decode('utf-8')
+                return json.loads(body) if body else None
+            except (ValueError, json.JSONDecodeError):
+                return None
+        return None

{mimicker-2.0.2 → mimicker-2.0.3}/mimicker/route.py

@@ -21,7 +21,7 @@ class Route:
         self._delay = 0.
         self._status = 200
         self._headers: List[Tuple[str, str]] = []
-        self._response_func: Optional[Callable[[], Tuple[int, Any]]] = None
+        self._response_func: Optional[Callable[..., Tuple[int, Any]]] = None
 
         escaped_path = re.escape(path)
         parameterized_path = re.sub(r'\\{(\w+)\\}',
@@ -81,12 +81,12 @@ class Route:
         self._headers = headers
         return self
 
-    def response_func(self, func: Callable[[], Tuple[int, Any]]):
+    def response_func(self, func: Callable[..., Tuple[int, Any]]):
         """
         Sets a custom response function for dynamic responses.
 
         Args:
-            func (Callable[[], Tuple[int, Any]]): A function returning a tuple (status_code, response_body).
+            func (Callable[..., Tuple[int, Any]]): A function that returns (status_code, response_body).
 
         Returns:
             Route: The current Route instance (for method chaining).

{mimicker-2.0.2 → mimicker-2.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "mimicker"
-version = "2.0.2"
+version = "2.0.3"
 description = "A lightweight HTTP mocking server for Python"
 authors = ["Amazia Gur <amaziagur@gmail.com>"]
 license = "MIT"