Pounce API Reference

ASGI protocol bridge.

Network layer — socket binding, listening, and TLS.

Protocol handlers for HTTP/1.1, HTTP/2, and WebSocket. Each protocol module translates between raw bytes on the...

Command-line interface for pounce.

Content encoding negotiation and compressor factory. Parses Accept-Encoding headers, selects the best encoding, and...

Error hierarchy for pounce. All pounce errors inherit from PounceError.

HTTP/2 connection handler — manages multiplexed streams over a single connection. Extracted from ``worker.py`` to...

Built-in health check endpoint. Responds to GET requests at the configured ``health_check_path`` before the request...

Application importer — resolves string references to ASGI callables.

HTTP Priority Signals (RFC 9218). Parses the ``Priority`` header (``u=N, i``) from HTTP/2 requests and provides a...

Proxy header validation — extract real client info from trusted reverse proxies. When ``trusted_hosts`` is...

File watcher for development mode (``--reload``). Polls the application's source directory for changes and signals...

Request ID generation and propagation. Each request gets a unique ID for tracing across logs and services. If a...

Runtime detection utilities. Detects GIL state and determines the appropriate worker mode for the current Python...

Timing utilities and Server-Timing header builder. Provides monotonic clock helpers for request-level timing and a...

ASGI type definitions for pounce. Typed definitions for the ASGI 3.0 protocol.

WebSocket connection handler — HTTP/1.1 upgrade lifecycle. Extracted from ``worker.py`` to keep protocol-specific...

Server configuration.

Connection lifecycle events — structured, immutable records. Each event captures a moment in a connection's...

Logging configuration and access log formatting. Configures stdlib logging with pounce-specific formatting.

Prometheus-compatible metrics collector. Implements the ``LifecycleCollector`` protocol to track standard...

Pounce — A free-threading-native ASGI server for Python 3.14t. Pounce is a pure-Python ASGI server designed from...

Server — orchestrates the full pounce lifecycle. Manages the state machine: CONFIG → DETECT → BIND → LIFESPAN →...

Supervisor — spawns, monitors, and restarts workers. The supervisor sits between the ``Server`` and the ``Worker``...

Worker — the heart of pounce's request handling. Runs a single asyncio event loop that accepts connections on a...