=XcA'ZdZddlmZddlZddlmZddlmZmZm Z gdZ Gdd e Z Gd d e Z Gd d e ZGdde ZGdde ZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGd d!eZGd"d#eZGd$d%eZGd&d'eZGd(d)eZGd*d+eZGd,d-eZGd.d/eZGd0d1e e Z!Gd2d3e Z"Gd4d5e Z#Gd6d7e Z$e$Z%y)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 ProtocolErrorWebSocketProtocolErrorceZdZdZy)r z? Base class for all exceptions defined by websockets. N__name__ __module__ __qualname____doc__7/usr/lib/python3/dist-packages/websockets/exceptions.pyr r Dr)r cVeZdZdZ d ddZd dZed dZed dZy) 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. Nc.||_||_||_yNrcvdsentrcvd_then_sent)selfr0r1r2s r*__init__zConnectionClosed.__init__Zs   ,r)c|j9|j|jJy|jJd|jdS|j|jJd|jdS|jJ|jrd|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 r/r3s r*__str__zConnectionClosed.__str__ds 99 yy **2228**222tyyk)BCCyy **222"499+-BCC**666&&&tyykdii[II"499+-=dii[IIr)cJ|jdS|jjS)Ni)r0coder6s r*r9zConnectionClosed.codeysyy(tstr)r>int) r$r%r&r'r4r7propertyr9r<r(r)r*r r Kse $*. -$-%-' -  -J*====r)r ceZdZdZy)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 sr)r ceZdZdZy)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 ceZdZdZy)r zK Raised during the handshake when the WebSocket connection fails. Nr#r(r)r*r r r+r)r ceZdZdZy)rzs Raised when a handshake request or response breaks a security rule. Security limits are hard coded. Nr#r(r)r*rrrFr)rceZdZdZy)rzD Raised when a handshake request or response is malformed. Nr#r(r)r*rrr+r)rc"eZdZdZdddZddZy)rzJ Raised when a HTTP header doesn't have a valid format or value. Nc ||_||_yr.namevaluer3rMrNs r*r4zInvalidHeader.__init__  r)c|jd|jdS|jdk(rd|jdSd|jd|jS)Nzmissing z headerr;zempty zinvalid z header: rNrMr6s r*r7zInvalidHeader.__str__sY :: dii[0 0 ZZ2 DII;g. .dii[ $**> >r)r.rMrArN Optional[str]r>r?r@r$r%r&r'r4r7r(r)r*rrs ?r)rc$eZdZdZdfd ZxZS)rz Raised when a HTTP header cannot be parsed. The format of the header doesn't match the grammar for that header. c6t|||d|d|y)Nz at z in superr4)r3rMerrorheaderpos __class__s r*r4zInvalidHeaderFormat.__init__s# %SEfX>?r)) rMrArZrAr[rAr\rBr>r?r$r%r&r'r4 __classcell__r]s@r*rrs@@r)rceZdZdZy)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*rrrFr)rc$eZdZdZdfd ZxZS)rzD Raised when the Origin header in a request isn't allowed. c&t|d|y)NOriginrX)r3originr]s r*r4zInvalidOrigin.__init__s 6*r))rerTr>r?r^r`s@r*rrs ++r)rceZdZdZy)rzF Raised when the Upgrade or Connection header isn't correct. Nr#r(r)r*rrr+r)rc eZdZdZddZddZy)rzJ Raised when a handshake response rejects the WebSocket upgrade. c||_yr.)response)r3ris r*r4zInvalidStatus.__init__s   r)c6d|jjdS)N+server rejected WebSocket connection: HTTP d)ri status_coder6s r*r7zInvalidStatus.__str__s# MM--a0 2 r)N)rizhttp11.Responser>r?r@rUr(r)r*rrs ! r)rc eZdZdZddZddZy)rzC Raised when a handshake response status code is invalid. c ||_||_yr.)rmheaders)r3rmrps r*r4zInvalidStatusCode.__init__s& r)c d|jS)Nrk)rmr6s r*r7zInvalidStatusCode.__str__sr?r@rUr(r)r*rrs Pr)rceZdZdZy)rz6 Raised when negotiating an extension fails. Nr#r(r)r*rrr+r)rc eZdZdZddZddZy)rzK Raised when a parameter name is repeated in an extension header. c||_yr.rMr3rMs r*r4zDuplicateParameter.__init__  r)c d|jS)Nzduplicate parameter: rur6s r*r7zDuplicateParameter.__str__s&tyyk22r)NrMrAr>r?r@rUr(r)r*rr s 3r)rc eZdZdZddZddZy)rzJ Raised when a parameter name in an extension header is invalid. c||_yr.rurvs r*r4zInvalidParameterName.__init__rwr)c d|jS)Nzinvalid parameter name: rur6s r*r7zInvalidParameterName.__str__ s)$))55r)Nryr@rUr(r)r*rrs 6r)rc eZdZdZddZddZy)rzK Raised when a parameter value in an extension header is invalid. c ||_||_yr.rLrOs r*r4zInvalidParameterValue.__init__*rPr)c|jd|jS|jdk(rd|jSd|jd|jS)Nzmissing value for parameter r;zempty value for parameter zinvalid value for parameter z: rRr6s r*r7zInvalidParameterValue.__str__.sU :: 1$))= = ZZ2 / {; ;1$))BtzzlK Kr)NrSr@rUr(r)r*rr$s Lr)rc2eZdZdZ d ddZddZy)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. cT||_tj||_||_yr.)statusrHeadersrpbody)r3rrprs r*r4zAbortHandshake.__init__Fs$  %--g6  r)c|d|jddt|jdt|jdS)NzHTTP rlz, z headers, z bytes)rlenrprr6s r*r7zAbortHandshake.__str__Ps<DKK?"4<< !499~f & r)N)r))rzhttp.HTTPStatusrpzdatastructures.HeadersLikerbytesr>r?r@rUr(r)r*rr7s< $ ,    r)rc eZdZdZddZddZy)rzd Raised when a handshake gets redirected. This exception is an implementation detail. c||_yr.uri)r3rs r*r4zRedirectHandshake.__init__`s r)c d|jS)Nz redirect to rr6s r*r7zRedirectHandshake.__str__csdhhZ((r)N)rrAr>r?r@rUr(r)r*rrXs)r)rceZdZdZy)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*rrgsr)rc eZdZdZddZddZy)rzM Raised when connecting to an URI that isn't a valid WebSocket URI. c ||_||_yr.rmsg)r3rrs r*r4zInvalidURI.__init__xsr)c8|jd|jS)Nz isn't a valid URI: rr6s r*r7zInvalidURI.__str__|s((/z::r)N)rrArrAr>r?r@rUr(r)r*rrrs ;r)rceZdZdZy)rzS Raised when receiving a frame with a payload exceeding the maximum size. Nr#r(r)r*rrr+r)rceZdZdZy)r z3 Raised when a frame breaks the protocol. Nr#r(r)r*r r r+r)r )&r' __future__rhttptypingrr;rrr__all__ Exceptionr r r r r rrrrrrrrrrrrrrrAssertionErrorrrrr r!r(r)r*rsg<# ,, :4=)4=n,))$%?$?& @- @+M+]  $  P( P' 3) 3 6+ 6L,L& % B )( )%~ ;# ;&&'r)