websocket-client/websocket-client
Websocket Client
This is a Python WebSocket client library designed to establish full-duplex, persistent network connections for real-time exchange of text and binary data. It functions as an asynchronous network client and a TCP socket wrapper, managing the complete lifecycle of a connection from the initial handshake to graceful closure.
The implementation includes a secure WebSocket client that handles SSL/TLS encryption, certificate verification, and secure handshake protocols. It further distinguishes itself by supporting advanced connectivity options, including proxy routing via HTTP or SOCKS proxies and the integration of custom Unix domain sockets.
The library provides broad capabilities for connection management, including heartbeat monitoring through ping and pong frames to detect timeouts and thread-safe session handling to prevent data corruption. It also includes tools for connection traffic tracing, custom frame masking, and the ability to configure specific handshake headers and subprotocols.
Features
- Persistent Full-Duplex Connections - Establishes persistent, bidirectional communication links for simultaneous two-way data exchange between client and server.
- WebSocket Clients - Provides a full-duplex Python library for establishing and managing bidirectional WebSocket connections over HTTP.
- Asynchronous Network Clients - Functions as a non-blocking network client utilizing event loops for concurrent data transmission.
- Websocket Connection Managers - Manages the full WebSocket lifecycle including connection establishment, heartbeat maintenance, and graceful closure.
- Data Framing - Packages text and binary payloads into discrete binary frames for network transmission according to the WebSocket protocol.
- Connection Lifecycle Managers - Manages the full state transition sequence of opening, transmitting, and closing persistent network connections.
- WebSocket Message Exchanges - Provides bidirectional transmission of text and binary frames over persistent WebSocket connections.
- WebSocket Connection Establishment - Handles the initial HTTP upgrade handshake to establish a real-time persistent WebSocket connection.
- Secure Connection Handlers - Manages secure connection layers including TLS encryption, hostname verification, and certificate validation.
- WebSocket Security - Implements security controls for persistent WebSocket connections including SSL/TLS encryption and certificate verification.
- Thread-Safe Client Handling - Ensures thread safety and prevents race conditions when multiple threads interact with the WebSocket client.
- Connection Control Frame Handlers - Manages protocol-level control frames and specifies opcodes to distinguish between text, binary, and control payloads.
- Connection Maintenance Loops - Runs a continuous execution loop to monitor network health and handle automatic reconnections for persistent sessions.
- Connection Closures - Provides mechanisms to gracefully shut down the WebSocket transport stream using specific status codes.
- Connection Managers - Uses an asynchronous dispatcher to manage several active network socket sessions within a single process.
- Unix Socket Connections - Supports establishing direct network connections using Unix domain sockets via filesystem paths.
- Incoming Message Processors - Dispatches received server messages to specific application handlers using custom subprotocols.
- WebSocket Proxy Routings - Routes WebSocket traffic through HTTP or SOCKS proxies to bypass network restrictions.
- Python Network Stacks - Provides a network communication implementation built using Python sockets for handling WebSocket traffic.
- Socket Abstractions - Provides a socket abstraction layer that supports custom IP addresses and Unix domain sockets.
- Socket Wrappers - Wraps standard network sockets to support Unix domain sockets and routing via HTTP or SOCKS proxies.
- Heartbeat Frames - Employs periodic application-level ping and pong frames to detect timeouts and maintain active network links.
- Thread-Safe Connection Sessions - Uses locking mechanisms to prevent data corruption when multiple threads interact with a single network connection.
- Callback-Based Event Dispatchers - Implements an event-driven dispatcher that routes incoming WebSocket protocol events to application-defined callback functions.
- Connection Configurators - Allows defining protocol-level settings such as handshake headers, subprotocols, and timeout values.
