Back to Explore

python-websockets/websockets

GitHub
1 watchersOpen source

Last release: 4 months ago

The websockets library helps you build WebSocket servers and clients in Python, with a coroutine-based API built on asyncio, plus optional threading and Sans I/O implementations. It is useful for building production-quality real-time WebSocket applications, and its documentation is hosted on Read the Docs.

Project status

  • Actively maintained, with a very recent upstream push (2026-05-17) and multiple versioned updates over the past year (15.0.1 in 2025-03, 16.0 in 2026-01).
  • Update cadence appears fairly regular, roughly every 1 to 3 months in the 14.x to 16.0 window (14.0 in 2024-11, 14.1 in 2024-11, 14.2 in 2025-01, 15.0 in 2025-02, 15.0.1 in 2025-03, 16.0 in 2026-01).

AI summary generated 2 weeks ago

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • 16.0

    4 months ago

    This release (16.0) raises the minimum supported Python version and introduces changes around connection/message limits and proxy/SOCKS handling. The provided release notes content is not included in the prompt (it only links to the changelog), so the analysis below flags likely behavioral and API surface changes directly visible in the code diff.

    BreakingFeatures

  • 15.0.1

    3/5/2025

    Release 15.0.1 primarily refactors the CLI implementation for the interactive WebSocket client and fixes an exit-related exception. The release notes (project changelog) only mention the bug fix, but the code diff shows a larger packaging and CLI entrypoint change.

    Features

  • 15.0

    2/16/2025

    Release 15.0 has release notes that defer to an external changelog page. In the code diff provided for 14.2 -> 15.0, the changes appear to be documentation-only (Sphinx docs restructuring, wording updates, and README edits), with no visible runtime/code changes.

  • 14.2

    1/19/2025

    Release 14.2 introduces a number of public API surface changes around re-exports and HTTP parsing behavior, plus internal connection/shutdown adjustments. The code diff shows multiple behavioral changes (exception types, transport closing semantics, and HTTP response body handling) that are not reflected in the provided release notes (only a changelog link is given).

    BreakingFeatures

  • 14.1

    11/13/2024

    Release 14.1 makes several internal and API-adjacent changes around connection state reporting and frame queue handling. It also extends the max_queue parameter to accept None (to support disabling flow control) and adds convenience properties like close_code and close_reason on connection objects.

    Features

  • 14.0

    11/9/2024

    Release 14.0 appears to focus on documentation updates, repository/test infrastructure adjustments, and CI tooling updates. In the diff provided, I do not see changes to the main library source code (for example, no modifications to `src/websockets/*`), so any consumer breaking changes would likely be configuration and packaging related.

  • 13.1

    9/21/2024

    Release 13.1 makes changes centered around concurrency handling in the asyncio implementation and reorganizes how several exception types are exported (including moving some legacy exceptions behind the .legacy namespace). The code diff also shows adjustments to the asyncio client handshake and introduces logic to decide which connection failures are retryable during reconnect.

    BreakingFeatures

  • 13.0.1

    8/28/2024

    Release 13.0.1 is a small maintenance update that primarily addresses packaging so the C extension is available again in the source distribution. The code changes are minimal and do not indicate any runtime API behavior changes in the library itself.

  • 13.0

    8/20/2024

    Release 13.0 appears to focus on introducing or promoting a new asyncio implementation (docs now distinguish websockets.asyncio versus websockets.legacy). In parallel, the repository build and CI workflows were modernized (new GitHub Actions versions, cibuildwheel bump, and a test matrix update). The provided release notes content is only a pointer to the changelog URL, with no inline details.

    Features

  • 12.0

    10/21/2023

    Release 12.0 introduces significant internal and public-surface refactors around typing and exports, including new convenience-import ergonomics. It also refactors WebSocket close code handling by introducing a CloseCode IntEnum and updating related exception and protocol logic to use it.

    BreakingFeatures