Collaboration with Development Teams on Quality Issues Questions

import json
import socket
import threading
from http.server import BaseHTTPRequestHandler, HTTPServer
import pytest

class _Handler(BaseHTTPRequestHandler):
    RESPONSES = {
        "/api/health": (200, {"status": "ok"}),
        "/api/data": (200, {"items": [1,2,3]}),
        "/api/error": (500, {"error": "down"}),
    }
    def do_GET(self):
        code, payload = self.RESPONSES.get(self.path, (404, {"error":"not found"}))
        self.send_response(code)
        self.send_header("Content-Type", "application/json")
        self.end_headers()
        self.wfile.write(json.dumps(payload).encode())

    def log_message(self, *args):  # silence logs in tests
        return

@pytest.fixture(scope="session")
def mock_service():
    # bind to an ephemeral port
    sock = socket.socket()
    sock.bind(("", 0))
    port = sock.getsockname()[1]
    sock.close()
    server = HTTPServer(("localhost", port), _Handler)
    thread = threading.Thread(target=server.serve_forever, daemon=True)
    thread.start()
    base = f"http://localhost:{port}"
    try:
        yield base  # tests receive base URL
    finally:
        server.shutdown()
        thread.join(timeout=1)
        server.server_close()