B ]bA'@sdZddlmZddlZddlmZddlmZmZm Z ddd d d d d ddddddddddddddddddgZ Gd dde Z Gd!dde Z Gd"d d e ZGd#d d e ZGd$d d e ZGd%d d eZGd&d d eZGd'ddeZGd(ddeZGd)ddeZGd*ddeZGd+ddeZGd,ddeZGd-ddeZGd.ddeZGd/ddeZGd0ddeZGd1ddeZGd2ddeZGd3ddeZGd4dde e Z!Gd5dde Z"Gd6dde Z#Gd7dde 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)datastructuresframeshttp11WebSocketExceptionConnectionClosedConnectionClosedErrorConnectionClosedOKInvalidHandshake SecurityErrorInvalidMessage InvalidHeaderInvalidHeaderFormatInvalidHeaderValue InvalidOriginInvalidUpgrade InvalidStatusInvalidStatusCodeNegotiationErrorDuplicateParameterInvalidParameterNameInvalidParameterValueAbortHandshakeRedirectHandshake InvalidState InvalidURI PayloadTooBig ProtocolErrorWebSocketProtocolErrorc@seZdZdZdS)rz? Base class for all exceptions defined by websockets. N)__name__ __module__ __qualname____doc__r%r%4lib/python3.7/site-packages/websockets/exceptions.pyrDsc@sXeZdZdZddddddddZd d d d Zed d ddZed d ddZdS)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. NzOptional[frames.Close]zOptional[bool]None)rcvdsentrcvd_then_sentreturncCs||_||_||_dS)N)r(r)r*)selfr(r)r*r%r%r&__init__ZszConnectionClosed.__init__str)r+cCs|jdkrD|jdkr&|jdks"tdS|jdks4td|jdSnb|jdkrj|jdks\td|jdS|jdk sxt|jrd|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*AssertionError)r,r%r%r&__str__ds   zConnectionClosed.__str__intcCs|jdkrdS|jjS)Ni)r(code)r,r%r%r&r2yszConnectionClosed.codecCs|jdkrdS|jjS)N)r(reason)r,r%r%r&r4}szConnectionClosed.reason)N) r!r"r#r$r-r0propertyr2r4r%r%r%r&r Ks  c@seZdZdZdS)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. N)r!r"r#r$r%r%r%r&r sc@seZdZdZdS)r z Like :exc:`ConnectionClosed`, when the connection terminated properly. A close code 1000 (OK) or 1001 (going away) was received and sent. N)r!r"r#r$r%r%r%r&r sc@seZdZdZdS)r zK Raised during the handshake when the WebSocket connection fails. N)r!r"r#r$r%r%r%r&r sc@seZdZdZdS)r zs Raised when a handshake request or response breaks a security rule. Security limits are hard coded. N)r!r"r#r$r%r%r%r&r sc@seZdZdZdS)rzD Raised when a handshake request or response is malformed. N)r!r"r#r$r%r%r%r&rsc@s2eZdZdZd ddddddZdd d d ZdS) rzJ Raised when a HTTP header doesn't have a valid format or value. Nr.z Optional[str]r')namevaluer+cCs||_||_dS)N)r6r7)r,r6r7r%r%r&r-szInvalidHeader.__init__)r+cCsH|jdkrd|jdS|jdkr0d|jdSd|jd|jSdS)Nzmissing z headerr3zempty zinvalid z header: )r7r6)r,r%r%r&r0s   zInvalidHeader.__str__)N)r!r"r#r$r-r0r%r%r%r&rscs.eZdZdZddddddfdd ZZS)rz Raised when a HTTP header cannot be parsed. The format of the header doesn't match the grammar for that header. r.r1r')r6errorheaderposr+cs"t||d|d|dS)Nz at z in )superr-)r,r6r8r9r:) __class__r%r&r-szInvalidHeaderFormat.__init__)r!r"r#r$r- __classcell__r%r%)r<r&rsc@seZdZdZdS)rz~ Raised when a HTTP header has a wrong value. The format of the header is correct but a value isn't acceptable. N)r!r"r#r$r%r%r%r&rscs(eZdZdZdddfdd ZZS)rzD Raised when the Origin header in a request isn't allowed. z Optional[str]r')originr+cstd|dS)NZOrigin)r;r-)r,r>)r<r%r&r-szInvalidOrigin.__init__)r!r"r#r$r-r=r%r%)r<r&rsc@seZdZdZdS)rzF Raised when the Upgrade or Connection header isn't correct. N)r!r"r#r$r%r%r%r&rsc@s.eZdZdZdddddZddd d Zd S) rzJ Raised when a handshake response rejects the WebSocket upgrade. zhttp11.Responser')responser+cCs ||_dS)N)r?)r,r?r%r%r&r-szInvalidStatus.__init__r.)r+cCsd|jjdS)Nz+server rejected WebSocket connection: HTTP d)r? status_code)r,r%r%r&r0szInvalidStatus.__str__N)r!r"r#r$r-r0r%r%r%r&rsc@s0eZdZdZddddddZdd d d Zd S) rzC Raised when a handshake response status code is invalid. r1zdatastructures.Headersr')rAheadersr+cCs||_||_dS)N)rArB)r,rArBr%r%r&r-szInvalidStatusCode.__init__r.)r+cCs d|jS)Nz+server rejected WebSocket connection: HTTP )rA)r,r%r%r&r0szInvalidStatusCode.__str__N)r!r"r#r$r-r0r%r%r%r&rsc@seZdZdZdS)rz6 Raised when negotiating an extension fails. N)r!r"r#r$r%r%r%r&rsc@s.eZdZdZdddddZdddd Zd S) rzK Raised when a parameter name is repeated in an extension header. r.r')r6r+cCs ||_dS)N)r6)r,r6r%r%r&r-szDuplicateParameter.__init__)r+cCs d|jS)Nzduplicate parameter: )r6)r,r%r%r&r0szDuplicateParameter.__str__N)r!r"r#r$r-r0r%r%r%r&r sc@s.eZdZdZdddddZdddd Zd S) rzJ Raised when a parameter name in an extension header is invalid. r.r')r6r+cCs ||_dS)N)r6)r,r6r%r%r&r-szInvalidParameterName.__init__)r+cCs d|jS)Nzinvalid parameter name: )r6)r,r%r%r&r0 szInvalidParameterName.__str__N)r!r"r#r$r-r0r%r%r%r&rsc@s0eZdZdZddddddZddd d Zd S) rzK Raised when a parameter value in an extension header is invalid. r.z Optional[str]r')r6r7r+cCs||_||_dS)N)r6r7)r,r6r7r%r%r&r-*szInvalidParameterValue.__init__)r+cCsD|jdkrd|jS|jdkr,d|jSd|jd|jSdS)Nzmissing value for parameter r3zempty value for parameter zinvalid value for parameter z: )r7r6)r,r%r%r&r0.s     zInvalidParameterValue.__str__N)r!r"r#r$r-r0r%r%r%r&r$sc@s4eZdZdZdddddddd Zd d d d ZdS)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. zhttp.HTTPStatuszdatastructures.HeadersLikebytesr')statusrBbodyr+cCs||_t||_||_dS)N)rErZHeadersrBrF)r,rErBrFr%r%r&r-Fs zAbortHandshake.__init__r.)r+cCs(d|jddt|jdt|jdS)NzHTTP r@z, z headers, z bytes)rElenrBrF)r,r%r%r&r0PszAbortHandshake.__str__N)rC)r!r"r#r$r-r0r%r%r%r&r7s c@s.eZdZdZdddddZdddd Zd S) rzd Raised when a handshake gets redirected. This exception is an implementation detail. r.r')urir+cCs ||_dS)N)rH)r,rHr%r%r&r-`szRedirectHandshake.__init__)r+cCs d|jS)Nz redirect to )rH)r,r%r%r&r0cszRedirectHandshake.__str__N)r!r"r#r$r-r0r%r%r%r&rXsc@seZdZdZdS)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. N)r!r"r#r$r%r%r%r&rgsc@s0eZdZdZddddddZdddd Zd S) rzM Raised when connecting to an URI that isn't a valid WebSocket URI. r.r')rHmsgr+cCs||_||_dS)N)rHrI)r,rHrIr%r%r&r-xszInvalidURI.__init__)r+cCs|jd|jS)Nz isn't a valid URI: )rHrI)r,r%r%r&r0|szInvalidURI.__str__N)r!r"r#r$r-r0r%r%r%r&rrsc@seZdZdZdS)rzS Raised when receiving a frame with a payload exceeding the maximum size. N)r!r"r#r$r%r%r%r&rsc@seZdZdZdS)rz3 Raised when a frame breaks the protocol. N)r!r"r#r$r%r%r%r&rs)&r$Z __future__rZhttptypingrr3rrr__all__ Exceptionrr r r r r rrrrrrrrrrrrrrr/rrrrr r%r%r%r&sl  7        !