a њh 2@sdZddlmZddlZddlmZgdZGdddeZGd d d eZ Gd d d e Z Gd dde Z GdddeZ GdddeZ GdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdd d eZGd!d"d"eZGd#d$d$eZGd%d&d&eZGd'd(d(eZGd)d*d*eZGd+d,d,eZGd-d.d.eZGd/d0d0eZGd1d2d2eZGd3d4d4eZGd5d6d6eZGd7d8d8ee Z!Gd9d:d:ee"Z#dd;l$m%Z%m&Z&ee'ddS)?aU :mod:`websockets.exceptions` defines the following hierarchy of exceptions. * :exc:`WebSocketException` * :exc:`ConnectionClosed` * :exc:`ConnectionClosedOK` * :exc:`ConnectionClosedError` * :exc:`InvalidURI` * :exc:`InvalidProxy` * :exc:`InvalidHandshake` * :exc:`SecurityError` * :exc:`ProxyError` * :exc:`InvalidProxyMessage` * :exc:`InvalidProxyStatus` * :exc:`InvalidMessage` * :exc:`InvalidStatus` * :exc:`InvalidStatusCode` (legacy) * :exc:`InvalidHeader` * :exc:`InvalidHeaderFormat` * :exc:`InvalidHeaderValue` * :exc:`InvalidOrigin` * :exc:`InvalidUpgrade` * :exc:`NegotiationError` * :exc:`DuplicateParameter` * :exc:`InvalidParameterName` * :exc:`InvalidParameterValue` * :exc:`AbortHandshake` (legacy) * :exc:`RedirectHandshake` (legacy) * :exc:`ProtocolError` (Sans-I/O) * :exc:`PayloadTooBig` (Sans-I/O) * :exc:`InvalidState` (Sans-I/O) * :exc:`ConcurrencyError` ) annotationsN) lazy_import)WebSocketExceptionConnectionClosedConnectionClosedOKConnectionClosedError InvalidURI InvalidProxyInvalidHandshake SecurityError ProxyErrorInvalidProxyMessageInvalidProxyStatusInvalidMessage InvalidStatus InvalidHeaderInvalidHeaderFormatInvalidHeaderValue InvalidOriginInvalidUpgradeNegotiationErrorDuplicateParameterInvalidParameterNameInvalidParameterValue ProtocolError PayloadTooBig InvalidStateConcurrencyErrorc@seZdZdZdS)rz? Base class for all exceptions defined by websockets. N__name__ __module__ __qualname____doc__r$r$P/wd/webapps/venvs/v2025_4um/lib/python3.9/site-packages/websockets/exceptions.pyrIsrc@sXeZdZdZddddddddZd d d d Zed d ddZed d ddZdS)ra Raised when trying to interact with a closed connection. Attributes: rcvd: If a close frame was received, its code and reason are available in ``rcvd.code`` and ``rcvd.reason``. sent: If a close frame was sent, its code and reason are available in ``sent.code`` and ``sent.reason``. rcvd_then_sent: If close frames were received and sent, this attribute tells in which order this happened, from the perspective of this side of the connection. Nzframes.Close | Nonez bool | NoneNone)rcvdsentrcvd_then_sentreturncCs8||_||_||_|jdu|jdup,|jduks4JdSNr'r(r))selfr'r(r)r$r$r%__init___szConnectionClosed.__init__strr*cCsr|jdur(|jdurdSd|jdSnF|jdur@d|jdS|jrZd|jd|jSd|jd|jSdS)Nzno close frame received or sentzsent z; no close frame receivedz received z; no close frame sentz ; then sent z; then received r,r-r$r$r%__str__js   zConnectionClosed.__str__intcCs&tdt|jdurtjjS|jjS)NzZConnectionClosed.code is deprecated; use Protocol.close_code or ConnectionClosed.rcvd.code)warningswarnDeprecationWarningr'framesZ CloseCodeZABNORMAL_CLOSUREcoder1r$r$r%r8{s zConnectionClosed.codecCs"tdt|jdurdS|jjS)Nz`ConnectionClosed.reason is deprecated; use Protocol.close_reason or ConnectionClosed.rcvd.reason)r4r5r6r'reasonr1r$r$r%r:s zConnectionClosed.reason)N) r r!r"r#r.r2propertyr8r:r$r$r$r%rPs  rc@seZdZdZdS)rz Like :exc:`ConnectionClosed`, when the connection terminated properly. A close code with code 1000 (OK) or 1001 (going away) or without a code was received and sent. Nrr$r$r$r%rsrc@seZdZdZdS)rz Like :exc:`ConnectionClosed`, when the connection terminated with an error. A close frame with a code other than 1000 (OK) or 1001 (going away) was received or sent, or the closing handshake didn't complete properly. Nrr$r$r$r%rsrc@s0eZdZdZddddddZdddd Zd S) r zL Raised when connecting to a URI that isn't a valid WebSocket URI. r/r&)urimsgr*cCs||_||_dSr+r<r=)r-r<r=r$r$r%r.szInvalidURI.__init__r0cCs|jd|jS)Nz isn't a valid URI: r>r1r$r$r%r2szInvalidURI.__str__Nr r!r"r#r.r2r$r$r$r%r sr c@s0eZdZdZddddddZdddd Zd S) r z? Raised when connecting via a proxy that isn't valid. r/r&)proxyr=r*cCs||_||_dSr+r@r=)r-r@r=r$r$r%r.szInvalidProxy.__init__r0cCs|jd|jS)Nz isn't a valid proxy: rAr1r$r$r%r2szInvalidProxy.__str__Nr?r$r$r$r%r sr c@seZdZdZdS)r zM Base class for exceptions raised when the opening handshake fails. Nrr$r$r$r%r sr c@seZdZdZdS)r z Raised when a handshake request or response breaks a security rule. Security limits can be configured with :doc:`environment variables <../reference/variables>`. Nrr$r$r$r%r sr c@seZdZdZdS)r z5 Raised when failing to connect to a proxy. Nrr$r$r$r%r sr c@seZdZdZdS)rz; Raised when an HTTP proxy response is malformed. Nrr$r$r$r%rsrc@s.eZdZdZdddddZddd d Zd S) rz< Raised when an HTTP proxy rejects the connection. http11.Responser&responser*cCs ||_dSr+rDr-rDr$r$r%r.szInvalidProxyStatus.__init__r/r0cCsd|jjdS)Nz proxy rejected connection: HTTP drD status_coder1r$r$r%r2szInvalidProxyStatus.__str__Nr?r$r$r$r%rsrc@seZdZdZdS)rzD Raised when a handshake request or response is malformed. Nrr$r$r$r%rsrc@s.eZdZdZdddddZddd d Zd S) rzJ Raised when a handshake response rejects the WebSocket upgrade. rBr&rCcCs ||_dSr+rErFr$r$r%r.szInvalidStatus.__init__r/r0cCsd|jjdS)Nz+server rejected WebSocket connection: HTTP rGrHr1r$r$r%r2szInvalidStatus.__str__Nr?r$r$r$r%rsrc@s2eZdZdZd ddddddZdd d d ZdS) rzK Raised when an HTTP header doesn't have a valid format or value. Nr/ str | Noner&namevaluer*cCs||_||_dSr+rLrMr-rLrMr$r$r%r. szInvalidHeader.__init__r0cCsH|jdurd|jdS|jdkr0d|jdSd|jd|jSdS)Nzmissing z headerr9zempty zinvalid z header: rMrLr1r$r$r%r2s   zInvalidHeader.__str__)Nr?r$r$r$r%rsrcs.eZdZdZddddddfdd ZZS)rz Raised when an HTTP header cannot be parsed. The format of the header doesn't match the grammar for that header. r/r3r&)rLerrorheaderposr*cs"t||d|d|dS)Nz at z in superr.)r-rLrQrRrS __class__r$r%r.szInvalidHeaderFormat.__init__r r!r"r#r. __classcell__r$r$rVr%rsrc@seZdZdZdS)rz Raised when an HTTP header has a wrong value. The format of the header is correct but the value isn't acceptable. Nrr$r$r$r%r#srcs(eZdZdZdddfdd ZZS)rzD Raised when the Origin header in a request isn't allowed. rJr&)originr*cstd|dS)NZOriginrT)r-rZrVr$r%r.2szInvalidOrigin.__init__rXr$r$rVr%r,src@seZdZdZdS)rzF Raised when the Upgrade or Connection header isn't correct. Nrr$r$r$r%r6src@seZdZdZdS)rzG Raised when negotiating an extension or a subprotocol fails. Nrr$r$r$r%r=src@s.eZdZdZdddddZdddd Zd S) rzK Raised when a parameter name is repeated in an extension header. r/r&rLr*cCs ||_dSr+rLr-rLr$r$r%r.JszDuplicateParameter.__init__r0cCs d|jS)Nzduplicate parameter: r\r1r$r$r%r2MszDuplicateParameter.__str__Nr?r$r$r$r%rDsrc@s.eZdZdZdddddZdddd Zd S) rzJ Raised when a parameter name in an extension header is invalid. r/r&r[cCs ||_dSr+r\r]r$r$r%r.WszInvalidParameterName.__init__r0cCs d|jS)Nzinvalid parameter name: r\r1r$r$r%r2ZszInvalidParameterName.__str__Nr?r$r$r$r%rQsrc@s0eZdZdZddddddZddd d Zd S) rzK Raised when a parameter value in an extension header is invalid. r/rJr&rKcCs||_||_dSr+rNrOr$r$r%r.dszInvalidParameterValue.__init__r0cCsD|jdurd|jS|jdkr,d|jSd|jd|jSdS)Nzmissing value for parameter r9zempty value for parameter zinvalid value for parameter z: rPr1r$r$r%r2hs     zInvalidParameterValue.__str__Nr?r$r$r$r%r^src@seZdZdZdS)ra Raised when receiving or sending a frame that breaks the protocol. The Sans-I/O implementation raises this exception when: * receiving or sending a frame that contains invalid data; * receiving or sending an invalid sequence of frames. Nrr$r$r$r%rqsrc@sDeZdZdZddddddddZd d d d Zddd ddZdS)raU Raised when parsing a frame with a payload that exceeds the maximum size. The Sans-I/O layer uses this exception internally. It doesn't bubble up to the I/O layer. The :meth:`~websockets.extensions.Extension.decode` method of extensions must raise :exc:`PayloadTooBig` if decoding a frame would exceed the limit. Nzint | None | strz int | Noner&)size_or_messagemax_sizecur_sizer*cCsht|tr6|dusJ|dus"Jtdt||_n.d|_||_|dusNJ||_d|_| |dS)NzMPayloadTooBig(message) is deprecated; change to PayloadTooBig(size, max_size)) isinstancer/r4r5r6messagesizer_r`set_current_size)r-r^r_r`r$r$r%r.s    zPayloadTooBig.__init__r/r0cCsf|jdur|jSd}|jdur0|d|jd7}|jdurL|d|jd7}|d|jd7}|SdS)Nzframe zwith z bytes zafter reading zexceeds limit of z bytes)rbrcr`r_)r-rbr$r$r%r2s   zPayloadTooBig.__str__)r`r*cCs.|jdusJ|dur*|j|7_||_dSr+)r`r_)r-r`r$r$r%rdszPayloadTooBig.set_current_size)NN)r r!r"r#r.r2rdr$r$r$r%r}s  rc@seZdZdZdS)ra Raised when sending a frame is forbidden in the current state. Specifically, the Sans-I/O layer raises this exception when: * sending a data frame to a connection in a state other :attr:`~websockets.protocol.State.OPEN`; * sending a control frame to a connection in a state other than :attr:`~websockets.protocol.State.OPEN` or :attr:`~websockets.protocol.State.CLOSING`. Nrr$r$r$r%rsrc@seZdZdZdS)rz Raised when receiving or sending messages concurrently. WebSocket is a connection-oriented protocol. Reads must be serialized; so must be writes. However, reading and writing concurrently is possible. Nrr$r$r$r%rsr)r7http11z.legacy.exceptions)ZAbortHandshakeZInvalidStatusCodeZRedirectHandshakeZWebSocketProtocolError)Zdeprecated_aliases)(r# __future__rr4Zimportsr__all__ Exceptionrrrrr r r r r rrrrrrrrrrrrrrrAssertionErrorr RuntimeErrorrr9r7reglobalsr$r$r$r%sN#  B          6