o _cA'@sdZddlmZddlZddlmZddlmZmZm Z gdZ Gdd d e Z Gd d d e Z Gd d d e ZGddde ZGddde ZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGd d!d!eZGd"d#d#eZGd$d%d%eZGd&d'd'eZGd(d)d)eZGd*d+d+eZGd,d-d-eZGd.d/d/eZGd0d1d1e e Z!Gd2d3d3e Z"Gd4d5d5e Z#Gd6d7d7e Z$e$Z%dS)8ay :mod:`websockets.exceptions` defines the following exception hierarchy: * :exc:`WebSocketException` * :exc:`ConnectionClosed` * :exc:`ConnectionClosedError` * :exc:`ConnectionClosedOK` * :exc:`InvalidHandshake` * :exc:`SecurityError` * :exc:`InvalidMessage` * :exc:`InvalidHeader` * :exc:`InvalidHeaderFormat` * :exc:`InvalidHeaderValue` * :exc:`InvalidOrigin` * :exc:`InvalidUpgrade` * :exc:`InvalidStatus` * :exc:`InvalidStatusCode` (legacy) * :exc:`NegotiationError` * :exc:`DuplicateParameter` * :exc:`InvalidParameterName` * :exc:`InvalidParameterValue` * :exc:`AbortHandshake` * :exc:`RedirectHandshake` * :exc:`InvalidState` * :exc:`InvalidURI` * :exc:`PayloadTooBig` * :exc:`ProtocolError` ) annotationsN)Optional)datastructuresframeshttp11)WebSocketExceptionConnectionClosedConnectionClosedErrorConnectionClosedOKInvalidHandshake SecurityErrorInvalidMessage InvalidHeaderInvalidHeaderFormatInvalidHeaderValue InvalidOriginInvalidUpgrade InvalidStatusInvalidStatusCodeNegotiationErrorDuplicateParameterInvalidParameterNameInvalidParameterValueAbortHandshakeRedirectHandshake InvalidState InvalidURI PayloadTooBig ProtocolErrorWebSocketProtocolErrorc@eZdZdZdS)rz? Base class for all exceptions defined by websockets. N__name__ __module__ __qualname____doc__r'r'@/usr/local/lib/python3.10/dist-packages/websockets/exceptions.pyrDrc@sDeZdZdZ ddd d Zdd dZedddZedddZdS)r aG Raised when trying to interact with a closed connection. Attributes: rcvd (Optional[Close]): if a close frame was received, its code and reason are available in ``rcvd.code`` and ``rcvd.reason``. sent (Optional[Close]): if a close frame was sent, its code and reason are available in ``sent.code`` and ``sent.reason``. rcvd_then_sent (Optional[bool]): if close frames were received and sent, this attribute tells in which order this happened, from the perspective of this side of the connection. NrcvdOptional[frames.Close]sentrcvd_then_sentOptional[bool]returnNonecCs||_||_||_dSNr*r,r-)selfr*r,r-r'r'r(__init__Zs zConnectionClosed.__init__strcCs|jdur!|jdur|jdusJdS|jdusJd|jdS|jdur4|jdus-Jd|jdS|jdus;J|jrHd|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 r2r3r'r'r(__str__ds   zConnectionClosed.__str__intcC|jdurdS|jjS)Ni)r*coder6r'r'r(r:yzConnectionClosed.codecCr9)N)r*reasonr6r'r'r(r=}r;zConnectionClosed.reasonr1)r*r+r,r+r-r.r/r0r/r5)r/r8) r#r$r%r&r4r7propertyr:r=r'r'r'r(r Ks  r c@r!)r z Like :exc:`ConnectionClosed`, when the connection terminated with an error. A close 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(r r)r c@r!)r z Like :exc:`ConnectionClosed`, when the connection terminated properly. A close code 1000 (OK) or 1001 (going away) was received and sent. Nr"r'r'r'r(r r)r c@r!)r zK Raised during the handshake when the WebSocket connection fails. Nr"r'r'r'r(r r)r c@r!)r zs Raised when a handshake request or response breaks a security rule. Security limits are hard coded. Nr"r'r'r'r(r r)r c@r!)rzD Raised when a handshake request or response is malformed. Nr"r'r'r'r(rr)rc@s&eZdZdZd dd d Zdd d ZdS)rzJ Raised when a HTTP header doesn't have a valid format or value. Nnamer5value Optional[str]r/r0cC||_||_dSr1r@rAr3r@rAr'r'r(r4 zInvalidHeader.__init__cCsD|jdur d|jdS|jdkrd|jdSd|jd|jS)Nzmissing z headerr<zempty zinvalid z header: rAr@r6r'r'r(r7s  zInvalidHeader.__str__r1r@r5rArBr/r0r>r#r$r%r&r4r7r'r'r'r(rs rcs"eZdZdZd fd d ZZS) rz Raised when a HTTP header cannot be parsed. The format of the header doesn't match the grammar for that header. r@r5errorheaderposr8r/r0cs"t||d|d|dS)Nz at z in superr4)r3r@rJrKrL __class__r'r(r4s"zInvalidHeaderFormat.__init__) r@r5rJr5rKr5rLr8r/r0r#r$r%r&r4 __classcell__r'r'rOr(rsrc@r!)rz~ Raised when a HTTP header has a wrong value. The format of the header is correct but a value isn't acceptable. Nr"r'r'r'r(rr)rcs"eZdZdZdfdd ZZS) rzD Raised when the Origin header in a request isn't allowed. originrBr/r0cstd|dS)NZOriginrM)r3rSrOr'r(r4zInvalidOrigin.__init__)rSrBr/r0rQr'r'rOr(rsrc@r!)rzF Raised when the Upgrade or Connection header isn't correct. Nr"r'r'r'r(rr)rc@s$eZdZdZd ddZd d d Zd S)rzJ Raised when a handshake response rejects the WebSocket upgrade. responsehttp11.Responser/r0cC ||_dSr1)rU)r3rUr'r'r(r4 zInvalidStatus.__init__r5cCsd|jjdS)N+server rejected WebSocket connection: HTTP d)rU status_coder6r'r'r(r7szInvalidStatus.__str__N)rUrVr/r0r>rIr'r'r'r(r rc@s$eZdZdZddd Zdd d Zd S)rzC Raised when a handshake response status code is invalid. r[r8headersdatastructures.Headersr/r0cCrCr1)r[r])r3r[r]r'r'r(r4rFzInvalidStatusCode.__init__r5cC d|jS)NrY)r[r6r'r'r(r7 zInvalidStatusCode.__str__N)r[r8r]r^r/r0r>rIr'r'r'r(r rc@r!)rz6 Raised when negotiating an extension fails. Nr"r'r'r'r(rr)rc@$eZdZdZd ddZd dd Zd S) rzK Raised when a parameter name is repeated in an extension header. r@r5r/r0cCrWr1r@r3r@r'r'r(r4rXzDuplicateParameter.__init__cCr_)Nzduplicate parameter: rcr6r'r'r(r7r`zDuplicateParameter.__str__Nr@r5r/r0r>rIr'r'r'r(r r\rc@rb) rzJ Raised when a parameter name in an extension header is invalid. r@r5r/r0cCrWr1rcrdr'r'r(r4rXzInvalidParameterName.__init__cCr_)Nzinvalid parameter name: rcr6r'r'r(r7 r`zInvalidParameterName.__str__Nrer>rIr'r'r'r(rr\rc@s$eZdZdZd dd Zdd d Zd S)rzK Raised when a parameter value in an extension header is invalid. r@r5rArBr/r0cCrCr1rDrEr'r'r(r4*rFzInvalidParameterValue.__init__cCs@|jdur d|jS|jdkrd|jSd|jd|jS)Nzmissing value for parameter r<zempty value for parameter zinvalid value for parameter z: rGr6r'r'r(r7.s    zInvalidParameterValue.__str__NrHr>rIr'r'r'r(r$rarc@s(eZdZdZ ddd d ZdddZdS)ra Raised to abort the handshake on purpose and return a HTTP response. This exception is an implementation detail. The public API is :meth:`~websockets.server.WebSocketServerProtocol.process_request`. Attributes: status (~http.HTTPStatus): HTTP status code. headers (Headers): HTTP response headers. body (bytes): HTTP response body. statushttp.HTTPStatusr]datastructures.HeadersLikebodybytesr/r0cCs||_t||_||_dSr1)rgrZHeadersr]rj)r3rgr]rjr'r'r(r4Fs  zAbortHandshake.__init__r5cCs(d|jddt|jdt|jdS)NzHTTP rZz, z headers, z bytes)rglenr]rjr6r'r'r(r7Ps zAbortHandshake.__str__N)rf)rgrhr]rirjrkr/r0r>rIr'r'r'r(r7s   rc@rb) rzd Raised when a handshake gets redirected. This exception is an implementation detail. urir5r/r0cCrWr1rm)r3rmr'r'r(r4`rXzRedirectHandshake.__init__cCr_)Nz redirect to rnr6r'r'r(r7cr`zRedirectHandshake.__str__N)rmr5r/r0r>rIr'r'r'r(rXs rc@r!)rz Raised when an operation is forbidden in the current state. This exception is an implementation detail. It should never be raised in normal circumstances. Nr"r'r'r'r(rgr)rc@s$eZdZdZd ddZd d d Zd S)rzM Raised when connecting to an URI that isn't a valid WebSocket URI. rmr5msgr/r0cCrCr1rmro)r3rmror'r'r(r4xrFzInvalidURI.__init__cCs|jd|jS)Nz isn't a valid URI: rpr6r'r'r(r7|rTzInvalidURI.__str__N)rmr5ror5r/r0r>rIr'r'r'r(rrrarc@r!)rzS Raised when receiving a frame with a payload exceeding the maximum size. Nr"r'r'r'r(rr)rc@r!)rz3 Raised when a frame breaks the protocol. Nr"r'r'r'r(rr)r)&r& __future__rhttptypingrr<rrr__all__ Exceptionrr r r r r rrrrrrrrrrrrrrAssertionErrorrrrrr r'r'r'r(s>  7        !