1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
Release History
===============
1.3.2 (2025-11-20)
------------------
- Fix type hints to allow BytesMessage to accept bytes again, as well as
bytearray.
1.3.1 (2025-11-12)
------------------
- Add additional license identifier to pyproject.toml.
- Use Python 3.13 to build the docs to match ReadTheDocs build environment.
1.3.0 (2025-11-11)
------------------
- Require h11>=0.16 dependency.
- Fix "Upgrade" header value to match RFC.
- Add reason "Switching Protocols" to handshake response.
- Add docs for `wsproto.Connection`
- Add support for Python 3.12, 3.13, and 3.14.
- Drop support for Python 3.7, 3.8, and 3.9.
- Improve Python typing, specifically bytes vs. bytearray.
- Various linting, styling, and packaging improvements.
1.2.0 (2022-08-23)
------------------
- Bugfix: When a close frame with status NO_STATUS_RCVD is sent, send
and empty payload.
- Bugfix: Changing both encoding and decoding of the Host, from ascii
to idna.
- Bugfix: Support multiple Sec-WebSocket-Extensions and
Sec-WebSocket-Protocol headers.
- Accept bytes alongside string as path argument in
initiate_upgrade_connection.
- Check the state when sending events, raising if the event cannot be
sent in the current state.
1.1.0 (2022-02-27)
------------------
- Added support for Python 3.10.
- Drop support for Python 3.6, meaning the minimum supported version
is Python 3.7.0.
- Various type checking and code linting improvements.
1.0.0 (2020-11-22)
------------------
- Added support for Python 3.8 and 3.9.
- Prevent invalid window bit sizes.
- Various docs, type checking, tooling and testing improvements.
0.15.0 (2019-08-10)
-------------------
**This contains all the Bugfixes in the 0.14 branch.**
- Drop support for Python 2. Please pin to ~= 0.14.0 if you support
Python 2.
- Drop support for Python 3.5, meaning the minimum supported version
is Python 3.6.1.
- Switch events to be dataclass based, otherwise the API is
consistent.
- Add type hints throughout and support PEP 561 via a py.typed
file. This should allow projects that use wsproto to type check their
usage of wsproto.
- Bugfix prevent the test folder being installed as a package called
test.
- Explicitly require Host header in handshake.
- Drop wsaccel support and utilise the aiohttp/@willmcgugan masking
method. wsaccel is unmaintained and this new masking method is
almost as quick.
0.14.1 (2019-05-30)
-------------------
- Loosen the h11 requirement to >= 0.8.1 as wsproto is compatible with
0.9 onwards.
- Stop installing a "test" package on installation.
0.14.0 (2019-04-06)
-------------------
- Bugfix clarify subprotocol type as str not bytes.
- Support HTTP/2 WebSockets. This requires a HTTP/2 parser (not
included), with hyper-h2 recommended. It renames
``handshake_extensions`` and hence is a breaking change.
- Bugfix badly formatted type hints.
- Bugfix minor issues identified by type checking.
0.13.0 (2019-01-24)
-------------------
- Introduce a send method on the connection which accepts the new
events. This requires the following usage changes, ::
connection.accept(subprotocol=subprotocol) -> connection.send(AcceptConnection(subprotocol=subprotocol))
connection.send_data(data) -> connection.send(Message(payload=payload))
connection.close(code) -> connection.send(CloseConnection(code=code))
connection.ping() -> connection.send(Ping())
connection.pong() -> connection.send(Pong())
- The Event structure is altered to allow for events to be sent and
received, this requires the following name changes in existing code, ::
ConnectionRequested -> Request
ConnectionEstablished -> AcceptConnection
ConnectionClosed -> CloseConnection
DataReceived -> Message
TextReceived -> TextMessage
BytesReceived -> BytesMessage
PingReceived -> Ping
PongReceived -> Pong
- Introduce RejectConnection and RejectData events to be used by a
server connection to reject rather than accept a connection or by a
client connection to emit the rejection response. The RejectData
event represents the rejection response body, if present.
- Add an extra_headers field to the AcceptConnection event in order to
customise the acceptance response in server mode or to emit this
information in client mode.
- Switch from Fail events being returned to raising ``RemoteProtocolError``.
- Switch from ValueError`s to LocalProtocolError`s being raised when
an action is taken that is incompatible with the connection state or
websocket standard.
- Enforce version checking in SERVER mode, only 13 is supported.
- Add an event_hint to RemoteProtocolErrors to hint at how to respond
to issues.
- Switch from a ``bytes_to_send`` method to the ``send`` method
returning the bytes to send directly. Responses to Ping and Close
messages must now be sent (via ``send``), with the ``Ping`` and
``CloseConnection`` events gaining a ``response`` method. This
allows ::
if isinstance(event, Ping):
bytes_to_send = connection.send(event.response())
- Separate the handshake from the active connection handling. This
allows the handshake and connection to be seperately used. By
default though WSConnection does both.
- ``receive_bytes`` is renamed to ``receive_data`` and
``WSConnection`` should be imported from ``wsproto`` rather than
``wsproto.connection``.
0.12.0 (2018-09-23)
-------------------
- Support h11 ~0.8.1.
- Support Python 3.7.
- Make the close-handshake more explicit, by sending a close frame on
reciept of a close frame.
- Bugfix fix deflate after a non-compressable message.
- Bugfix connection header acceptance, by accepting Connection header
values that are comma separated lists.
0.11.0 (2017-12-31)
-------------------
- Separate extension handling into its own method.
- Add events for PING and PONG frames.
- Stop supporting Python 3.4.
- Large increase in tests and test coverage.
- Bugfix extension accept for empty strings.
- Bugfix raise if default arguments are invalid.
0.10.0 (2017-05-03)
-------------------
- General improvements.
0.9.1 (2016-10-27)
------------------
- (unreleased on PyPI)
0.9.0 (2016-08-24)
------------------
- First release on PyPI.
|
