Add support for capturing all requests

.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.pyc
+*.pyo

Dockerfile

@@ -25,6 +25,7 @@ USER catcher
 WORKDIR /home/catcher
 
 COPY --chown=catcher:catcher --from=build /root/http-request-catcher /home/catcher
+COPY --chown=catcher:catcher app.py /home/catcher/app.py
 
 EXPOSE 5000
 

README.md

@@ -28,6 +28,52 @@ Refer [docs](https://docs.docker.com/) for general documentation and guides for
 docker run appwrite/requestcatcher
 ```
 
+### API Endpoints
+
+The RequestCatcher exposes the following endpoints:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/__last_request__` | GET | Returns the last captured request |
+| `/__all_requests__` | GET | Returns all captured requests (useful for parallel test runs) |
+| `/__find_request__` | GET | Find requests matching header/body values (see below) |
+| `/__clear__` | POST, DELETE | Clears all captured requests |
+| `/*` | Any | Captures any request made to any path |
+
+#### Example: Get All Requests
+
+```bash
+curl http://localhost:5000/__all_requests__
+```
+
+#### Example: Find Specific Request
+
+Find requests by header value:
+```bash
+curl "http://localhost:5000/__find_request__?header_X-Custom-Id=abc123"
+```
+
+Find requests by body content:
+```bash
+curl "http://localhost:5000/__find_request__?body=test-event"
+```
+
+Find requests by HTTP method:
+```bash
+curl "http://localhost:5000/__find_request__?method=POST"
+```
+
+Combine multiple filters:
+```bash
+curl "http://localhost:5000/__find_request__?method=POST&header_Content-Type=application/json"
+```
+
+#### Example: Clear Requests
+
+```bash
+curl -X POST http://localhost:5000/__clear__
+```
+
 ### Environment Variables
 
 This container supports all environment variables supplied by the original smarterdm/http-request-catcher Docker image.

app.py

@@ -0,0 +1,88 @@
+from datetime import datetime
+from flask import Flask, request, jsonify
+from os import environ
+
+app = Flask('HTTP Request Catcher')
+
+last_request = None
+all_requests = []
+
+
+@app.route('/__last_request__', methods=['GET'])
+def get_last_request():
+    return jsonify(last_request), 200
+
+
+@app.route('/__all_requests__', methods=['GET'])
+def get_all_requests():
+    return jsonify(all_requests), 200
+
+
+@app.route('/__find_request__', methods=['GET'])
+def find_request():
+    """
+    Find requests matching header or body values.
+    Query parameters:
+    - header_<name>=<value>: Match requests with specific header value
+    - body=<value>: Match requests containing this value in body
+    - method=<value>: Match requests with specific HTTP method
+    - url=<value>: Match requests with URL containing this value
+    """
+    matches = []
+
+    for req in all_requests:
+        match = True
+
+        for key, value in request.args.items():
+            if key.startswith('header_'):
+                header_name = key[7:]  # Remove 'header_' prefix
+                req_headers = {k.lower(): v for k, v in req['headers'].items()}
+                if req_headers.get(header_name.lower()) != value:
+                    match = False
+                    break
+            elif key == 'body':
+                if value not in req.get('data', ''):
+                    match = False
+                    break
+            elif key == 'method':
+                if req.get('method', '').upper() != value.upper():
+                    match = False
+                    break
+            elif key == 'url':
+                if value not in req.get('url', ''):
+                    match = False
+                    break
+
+        if match:
+            matches.append(req)
+
+    return jsonify(matches), 200
+
+
+@app.route('/__clear__', methods=['POST', 'DELETE'])
+def clear_requests():
+    global last_request, all_requests
+    last_request = None
+    all_requests = []
+    return '', 204
+
+
+@app.route('/', defaults={'path': ''}, methods=['PUT', 'POST', 'GET', 'HEAD', 'DELETE', 'PATCH', 'OPTIONS'])
+@app.route('/<path:path>', methods=['PUT', 'POST', 'GET', 'HEAD', 'DELETE', 'PATCH', 'OPTIONS'])
+def catch(path):
+    global last_request, all_requests
+
+    last_request = {
+        'method': request.method,
+        'data': request.data.decode('utf-8'),
+        'headers': dict(request.headers),
+        'url': request.url,
+        'time': datetime.now().isoformat(),
+    }
+    all_requests.append(last_request)
+
+    return '', 200
+
+
+if __name__ == '__main__':
+    app.run(host='0.0.0.0', port=5000)