Wsgiserver 0.2 May 2026

async def handle_client(self, reader, writer): data = await reader.read(4096) # Process request writer.write(response) await writer.drain() writer.close() 6.1 Hello World ( examples/hello_world.py ) from wsgiserver.server import WSGIServer def hello_world_app(environ, start_response): status = '200 OK' headers = [('Content-Type', 'text/html; charset=utf-8')] start_response(status, headers)

response = requests.get('http://127.0.0.1:8888/') assert response.status_code == 200 assert response.text == 'Hello, World!'

Overview WSGIServer 0.2 is a lightweight, pure-Python WSGI HTTP server compliant with PEP 3333. This guide covers development setup, architecture, implementation details, testing, and deployment. 1. Project Structure wsgiserver/ ├── wsgiserver/ │ ├── __init__.py │ ├── server.py # Main server class │ ├── handler.py # Request handler │ ├── connection.py # Connection management │ ├── request.py # Request parsing │ ├── response.py # Response building │ └── utils.py # Helper functions ├── tests/ │ ├── test_server.py │ ├── test_handler.py │ └── fixtures/ ├── examples/ │ ├── hello_world.py │ └── middleware_demo.py ├── docs/ ├── setup.py ├── README.md └── requirements.txt 2. Core Implementation 2.1 Main Server Class ( server.py ) import socket import select import threading from wsgiref.handlers import BaseHandler class WSGIServer: """WSGI-compliant HTTP server""" wsgiserver 0.2

# docker-compose.yml version: '3.8'

def __init__(self, client_socket, client_address, application): self.client_socket = client_socket self.client_address = client_address self.application = application self.request_data = b'' self.headers = {} self.method = '' self.path = '' self.http_version = '' def parse_request(self): """Parse raw HTTP request""" # Read request line data = self.client_socket.recv(4096) self.request_data = data # Parse request line lines = data.split(b'\r\n') if lines: request_line = lines[0].decode('utf-8') parts = request_line.split() if len(parts) >= 3: self.method = parts[0] self.path = parts[1] self.http_version = parts[2] # Parse headers for line in lines[1:]: if line == b'': break header_line = line.decode('utf-8') if ': ' in header_line: key, value = header_line.split(': ', 1) self.headers[key] = value def build_environ(self): """Build WSGI environ dictionary""" environ = 'REQUEST_METHOD': self.method, 'SCRIPT_NAME': '', 'PATH_INFO': self.path, 'QUERY_STRING': self.path.split('?', 1)[1] if '?' in self.path else '', 'CONTENT_TYPE': self.headers.get('Content-Type', ''), 'CONTENT_LENGTH': self.headers.get('Content-Length', ''), 'SERVER_NAME': self.client_socket.getsockname()[0], 'SERVER_PORT': str(self.client_socket.getsockname()[1]), 'SERVER_PROTOCOL': self.http_version, 'wsgi.version': (1, 0), 'wsgi.url_scheme': 'http', 'wsgi.input': BytesIO(self.request_data), 'wsgi.errors': sys.stderr, 'wsgi.multithread': True, 'wsgi.multiprocess': False, 'wsgi.run_once': False, # Add headers as HTTP_ prefixed variables for key, value in self.headers.items(): env_key = f"HTTP_key.replace('-', '_').upper()" environ[env_key] = value return environ def send_response(self, response_data, status, headers): """Send HTTP response to client""" response_line = f"HTTP/1.1 status\r\n" response = response_line.encode() for key, value in headers: response += f"key: value\r\n".encode() response += b"\r\n" if isinstance(response_data, bytes): response += response_data elif isinstance(response_data, str): response += response_data.encode() self.client_socket.sendall(response) def handle_request(self): """Process the request through WSGI application""" try: self.parse_request() environ = self.build_environ() # Call WSGI application result = self.application(environ, self.start_response) # Send response response_data = b''.join(result) self.send_response(response_data, self.status, self.headers_to_send) except Exception as e: self.send_error_response(str(e)) finally: self.client_socket.close() def start_response(self, status, headers, exc_info=None): """WSGI start_response callback""" self.status = status self.headers_to_send = headers return self.write def write(self, data): """Write response data (for older WSGI)""" # Handle chunked writing if needed pass def send_error_response(self, error_msg): """Send error response to client""" error_body = f"<html><body><h1>500 Internal Server Error</h1><p>error_msg</p></body></html>" self.send_response( error_body, "500 Internal Server Error", [('Content-Type', 'text/html')] ) 3.1 Virtual Environment # Create virtual environment python -m venv venv Activate it source venv/bin/activate # Linux/Mac or venv\Scripts\activate # Windows Upgrade pip pip install --upgrade pip 3.2 Requirements ( requirements.txt ) # Core dependencies (none - pure Python) # Development dependencies pytest>=7.0.0 pytest-cov>=4.0.0 black>=23.0.0 flake8>=6.0.0 mypy>=1.0.0 requests>=2.28.0 gunicorn>=20.1.0 # For comparison/testing 3.3 Installation # Install in development mode pip install -e . Install dev dependencies pip install -r requirements.txt 4. Testing Strategy 4.1 Unit Tests ( tests/test_server.py ) import pytest import threading import requests from wsgiserver.server import WSGIServer def test_basic_request(): """Test basic HTTP request/response""" def app(environ, start_response): start_response('200 OK', [('Content-Type', 'text/plain')]) return [b'Hello, World!'] async def handle_client(self, reader, writer): data = await

EXPOSE 8000

class MultiProcessServer: """Fork multiple worker processes""" Testing Strategy 4

server.shutdown() # Run all tests pytest With coverage pytest --cov=wsgiserver --cov-report=html Run specific test pytest tests/test_server.py::test_basic_request -v 5. Performance Optimization 5.1 Connection Pooling class ConnectionPool: """Manage persistent connections""" def __init__(self, max_connections=100): self.pool = [] self.max_connections = max_connections def acquire(self): if self.pool: return self.pool.pop() return None def release(self, connection): if len(self.pool) < self.max_connections: self.pool.append(connection) 5.2 Asynchronous Support import asyncio class AsyncWSGIServer: """Asynchronous version using asyncio"""