o Zh 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@eZdZdZdS)rz? Base class for all exceptions defined by websockets. N__name__ __module__ __qualname____doc__r%r%L/var/www/html/lang_env/lib/python3.10/site-packages/websockets/exceptions.pyrIrc@sDeZdZdZ ddd d Zdd dZedddZedddZdS)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. Nrcvdframes.Close | Nonesentrcvd_then_sent bool | NonereturnNonecCs8||_||_||_|jdu|jdup|jduksJdSNr(r*r+)selfr(r*r+r%r%r&__init___s&zConnectionClosed.__init__strcCsl|jdur|jdur dSd|jdS|jdurd|jdS|jr,d|jd|jSd|jd|jS)Nzno close frame received or sentzsent z; no close frame receivedz received z; no close frame sentz ; then sent z; then received r0r1r%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_CLOSUREcoder4r%r%r&r;{s zConnectionClosed.codecCs"tdt|jdur dS|jjS)Nz`ConnectionClosed.reason is deprecated; use Protocol.close_reason or ConnectionClosed.rcvd.reason)r7r8r9r(reasonr4r%r%r&r=s zConnectionClosed.reasonr/)r(r)r*r)r+r,r-r.r-r3)r-r6) r!r"r#r$r2r5propertyr;r=r%r%r%r&rPs   rc@r)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. Nr r%r%r%r&rr'rc@r)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. Nr r%r%r%r&rr'rc@$eZdZdZd ddZd d d Zd S)r zL Raised when connecting to a URI that isn't a valid WebSocket URI. urir3msgr-r.cC||_||_dSr/rArB)r1rArBr%r%r&r2 zInvalidURI.__init__cC|jd|jS)Nz isn't a valid URI: rDr4r%r%r&r5zInvalidURI.__str__N)rAr3rBr3r-r.r>r!r"r#r$r2r5r%r%r%r&r  r c@r@)r z? Raised when connecting via a proxy that isn't valid. proxyr3rBr-r.cCrCr/rJrB)r1rJrBr%r%r&r2rEzInvalidProxy.__init__cCrF)Nz isn't a valid proxy: rKr4r%r%r&r5rGzInvalidProxy.__str__N)rJr3rBr3r-r.r>rHr%r%r%r&r rIr c@r)r zM Base class for exceptions raised when the opening handshake fails. Nr r%r%r%r&r r'r c@r)r z Raised when a handshake request or response breaks a security rule. Security limits can be configured with :doc:`environment variables <../reference/variables>`. Nr r%r%r%r&r r'r c@r)r z5 Raised when failing to connect to a proxy. Nr r%r%r%r&r r'r c@r)rz; Raised when an HTTP proxy response is malformed. Nr r%r%r%r&rr'rc@$eZdZdZd ddZd d d Zd S)rz< Raised when an HTTP proxy rejects the connection. responsehttp11.Responser-r.cC ||_dSr/rMr1rMr%r%r&r2 zInvalidProxyStatus.__init__r3cCd|jjdS)Nz proxy rejected connection: HTTP drM status_coder4r%r%r&r5szInvalidProxyStatus.__str__NrMrNr-r.r>rHr%r%r%r&r rc@r)rzD Raised when a handshake request or response is malformed. Nr r%r%r%r&rr'rc@rL)rzJ Raised when a handshake response rejects the WebSocket upgrade. rMrNr-r.cCrOr/rPrQr%r%r&r2rRzInvalidStatus.__init__r3cCrS)Nz+server rejected WebSocket connection: HTTP rTrUr4r%r%r&r5szInvalidStatus.__str__NrWr>rHr%r%r%r&rrXrc@s&eZdZdZd dd d Zdd d ZdS)rzK Raised when an HTTP header doesn't have a valid format or value. Nnamer3value str | Noner-r.cCrCr/rYrZr1rYrZr%r%r&r2 rEzInvalidHeader.__init__cCsD|jdur d|jdS|jdkrd|jdSd|jd|jS)Nzmissing z headerr<zempty zinvalid z header: rZrYr4r%r%r&r5s  zInvalidHeader.__str__r/rYr3rZr[r-r.r>rHr%r%r%r&rs rcs"eZdZdZd fd d ZZS) rz Raised when an HTTP header cannot be parsed. The format of the header doesn't match the grammar for that header. rYr3errorheaderposr6r-r.cs"t||d|d|dS)Nz at z in superr2)r1rYr`rarb __class__r%r&r2s"zInvalidHeaderFormat.__init__) rYr3r`r3rar3rbr6r-r.r!r"r#r$r2 __classcell__r%r%rer&rsrc@r)rz Raised when an HTTP header has a wrong value. The format of the header is correct but the value isn't acceptable. Nr r%r%r%r&r#r'rcs"eZdZdZdfdd ZZS) rzD Raised when the Origin header in a request isn't allowed. originr[r-r.cstd|dS)NZOriginrc)r1rirer%r&r22rGzInvalidOrigin.__init__)rir[r-r.rgr%r%rer&r,src@r)rzF Raised when the Upgrade or Connection header isn't correct. Nr r%r%r%r&r6r'rc@r)rzG Raised when negotiating an extension or a subprotocol fails. Nr r%r%r%r&r=r'rc@$eZdZdZd ddZd dd Zd S) rzK Raised when a parameter name is repeated in an extension header. rYr3r-r.cCrOr/rYr1rYr%r%r&r2JrRzDuplicateParameter.__init__cC d|jS)Nzduplicate parameter: rkr4r%r%r&r5M zDuplicateParameter.__str__NrYr3r-r.r>rHr%r%r%r&rDrXrc@rj) rzJ Raised when a parameter name in an extension header is invalid. rYr3r-r.cCrOr/rkrlr%r%r&r2WrRzInvalidParameterName.__init__cCrm)Nzinvalid parameter name: rkr4r%r%r&r5ZrnzInvalidParameterName.__str__Nror>rHr%r%r%r&rQrXrc@s$eZdZdZd dd Zdd d Zd S)rzK Raised when a parameter value in an extension header is invalid. rYr3rZr[r-r.cCrCr/r\r]r%r%r&r2drEzInvalidParameterValue.__init__cCs@|jdur d|jS|jdkrd|jSd|jd|jS)Nzmissing value for parameter r<zempty value for parameter zinvalid value for parameter z: r^r4r%r%r&r5hs    zInvalidParameterValue.__str__Nr_r>rHr%r%r%r&r^rIrc@r)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. Nr r%r%r%r&rqr'rc@s4eZdZdZ  ddd d Zdd dZdddZdS)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. Nsize_or_messageint | None | strmax_size int | Nonecur_sizer-r.cCsjt|tr|dus J|dusJtdt||_dSd|_||_|dus(J||_d|_| |dS)NzMPayloadTooBig(message) is deprecated; change to PayloadTooBig(size, max_size)) isinstancer3r7r8r9messagesizerrrtset_current_size)r1rprrrtr%r%r&r2s     zPayloadTooBig.__init__r3cCsb|jdur|jSd}|jdur|d|jd7}|jdur&|d|jd7}|d|jd7}|S)Nzframe zwith z bytes zafter reading zexceeds limit of z bytes)rvrwrtrr)r1rvr%r%r&r5s   zPayloadTooBig.__str__cCs2|jdusJ|dur|j|7_||_dSdSr/)rtrr)r1rtr%r%r&rxs  zPayloadTooBig.set_current_size)NN)rprqrrrsrtrsr-r.r>)rtrsr-r.)r!r"r#r$r2r5rxr%r%r%r&r}s  rc@r)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`. Nr r%r%r%r&rr'rc@r)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. Nr r%r%r%r&rr'r)r:http11z.legacy.exceptions)ZAbortHandshakeZInvalidStatusCodeZRedirectHandshakeZWebSocketProtocolError)Zdeprecated_aliases)(r$ __future__rr7Zimportsr__all__ Exceptionrrrrr r r r r rrrrrrrrrrrrrrrAssertionErrorr RuntimeErrorrr<r:ryglobalsr%r%r%r&sP # B          6