golden hour
/opt/saltstack/salt/lib/python3.10/site-packages/salt/ext/tornado/__pycache__
⬆️ Go Up
Upload
File/Folder
Size
Actions
__init__.cpython-310.pyc
378 B
Del
OK
_locale_data.cpython-310.pyc
3.23 KB
Del
OK
auth.cpython-310.pyc
39.18 KB
Del
OK
autoreload.cpython-310.pyc
7.02 KB
Del
OK
concurrent.cpython-310.pyc
17.24 KB
Del
OK
curl_httpclient.cpython-310.pyc
12.8 KB
Del
OK
escape.cpython-310.pyc
9.89 KB
Del
OK
gen.cpython-310.pyc
38.39 KB
Del
OK
http1connection.cpython-310.pyc
19.47 KB
Del
OK
httpclient.cpython-310.pyc
25.19 KB
Del
OK
httpserver.cpython-310.pyc
11.45 KB
Del
OK
httputil.cpython-310.pyc
29.84 KB
Del
OK
ioloop.cpython-310.pyc
33.19 KB
Del
OK
iostream.cpython-310.pyc
42.97 KB
Del
OK
locale.cpython-310.pyc
15.22 KB
Del
OK
locks.cpython-310.pyc
16.61 KB
Del
OK
log.cpython-310.pyc
8.07 KB
Del
OK
netutil.cpython-310.pyc
14.32 KB
Del
OK
options.cpython-310.pyc
19.63 KB
Del
OK
process.cpython-310.pyc
10.27 KB
Del
OK
queues.cpython-310.pyc
11.29 KB
Del
OK
routing.cpython-310.pyc
21.08 KB
Del
OK
simple_httpclient.cpython-310.pyc
16.08 KB
Del
OK
stack_context.cpython-310.pyc
10.65 KB
Del
OK
tcpclient.cpython-310.pyc
6.49 KB
Del
OK
tcpserver.cpython-310.pyc
10.06 KB
Del
OK
template.cpython-310.pyc
30.52 KB
Del
OK
testing.cpython-310.pyc
24.61 KB
Del
OK
util.cpython-310.pyc
13.72 KB
Del
OK
web.cpython-310.pyc
105.22 KB
Del
OK
websocket.cpython-310.pyc
39.08 KB
Del
OK
wsgi.cpython-310.pyc
11.5 KB
Del
OK
Edit: websocket.cpython-310.pyc
o �xeǻ � @ s� d Z ddlmZmZmZ ddlZddlZddlZddlZddl Z ddl m m m Z ddlm m mZ ddlZddlmZ ddl mZmZmZ ddlmZmZmZ ddl m Z m Z ddl m Z dd l!m"Z"m#Z# dd lm$Z$ dd l%m&Z& dd l'm(Z(m)Z) e)r�dd l*m+Z+ e,Z-ndd l+m+Z+ G dd� de.�Z/G dd� de/�Z0G dd� dej1�Z2dd� Z3G dd� de4�Z5G dd� de4�Z6G dd� de4�Z7G d d � d e5�Z8G d d � d e$j9�Z: d"d d!�Z;dS )#a� Implementation of the WebSocket protocol. `WebSockets <http://dev.w3.org/html5/websockets/>`_ allow for bidirectional communication between the browser and server. WebSockets are supported in the current versions of all major browsers, although older versions that do not support WebSockets are still in use (refer to http://caniuse.com/websockets for details). This module implements the final version of the WebSocket protocol as defined in `RFC 6455 <http://tools.ietf.org/html/rfc6455>`_. Certain browser versions (notably Safari 5.x) implemented an earlier draft of the protocol (known as "draft 76") and are not compatible with this module. .. versionchanged:: 4.0 Removed support for the draft 76 protocol version. � )�absolute_import�division�print_functionN)�TracebackFuture)�utf8� native_str� to_unicode)�gen� httpclient�httputil)�IOLoop�PeriodicCallback)�StreamClosedError)�gen_log�app_log)�simple_httpclient)� TCPClient)�_websocket_mask�PY3)�urlparsec @ s e Zd ZdS )�WebSocketErrorN)�__name__� __module__� __qualname__� r r �N/opt/saltstack/salt/lib/python3.10/site-packages/salt/ext/tornado/websocket.pyr 1 s r c @ s e Zd ZdZdS )�WebSocketClosedErrorzLRaised by operations on a closed connection. .. versionadded:: 3.2 N)r r r �__doc__r r r r r 5 s r c s� e Zd ZdZ� fdd�Zejdd� �ZdZe dd� �Z e d d � �Z e d d � �Z d0dd�Z dd� Zdd� Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd1d d!�Zd"d#� Zd$d%� Zd&d'� Z� fd(d)�Z� fd*d+�Zd,d-� Z d.d/� Z � Z S )2�WebSocketHandlera� Subclass this class to create a basic WebSocket handler. Override `on_message` to handle incoming messages, and use `write_message` to send messages to the client. You can also override `open` and `on_close` to handle opened and closed connections. Custom upgrade response headers can be sent by overriding `~tornado.web.RequestHandler.set_default_headers` or `~tornado.web.RequestHandler.prepare`. See http://dev.w3.org/html5/websockets/ for details on the JavaScript interface. The protocol is specified at http://tools.ietf.org/html/rfc6455. Here is an example WebSocket handler that echos back all received messages back to the client: .. testcode:: class EchoWebSocket(tornado.websocket.WebSocketHandler): def open(self): print("WebSocket opened") def on_message(self, message): self.write_message(u"You said: " + message) def on_close(self): print("WebSocket closed") .. testoutput:: :hide: WebSockets are not standard HTTP connections. The "handshake" is HTTP, but after the handshake, the protocol is message-based. Consequently, most of the Tornado HTTP facilities are not available in handlers of this type. The only communication methods available to you are `write_message()`, `ping()`, and `close()`. Likewise, your request handler class should implement `open()` method rather than ``get()`` or ``post()``. If you map the handler above to ``/websocket`` in your application, you can invoke it in JavaScript with:: var ws = new WebSocket("ws://localhost:8888/websocket"); ws.onopen = function() { ws.send("Hello, world"); }; ws.onmessage = function (evt) { alert(evt.data); }; This script pops up an alert box that says "You said: Hello, world". Web browsers allow any site to open a websocket connection to any other, instead of using the same-origin policy that governs other network access from javascript. This can be surprising and is a potential security hole, so since Tornado 4.0 `WebSocketHandler` requires applications that wish to receive cross-origin websockets to opt in by overriding the `~WebSocketHandler.check_origin` method (see that method's docs for details). Failure to do so is the most likely cause of 403 errors when making a websocket connection. When using a secure websocket connection (``wss://``) with a self-signed certificate, the connection from a browser may fail because it wants to show the "accept this certificate" dialog but has nowhere to show it. You must first visit a regular HTML page using the same certificate to accept it before the websocket connection will succeed. If the application setting ``websocket_ping_interval`` has a non-zero value, a ping will be sent periodically, and the connection will be closed if a response is not received before the ``websocket_ping_timeout``. Messages larger than the ``websocket_max_message_size`` application setting (default 10MiB) will not be accepted. .. versionchanged:: 4.5 Added ``websocket_ping_interval``, ``websocket_ping_timeout``, and ``websocket_max_message_size``. c s< t t| �j||fi |�� d | _d | _d | _d | _d| _d S �NF)�superr �__init__� ws_connection� close_code� close_reason�stream�_on_close_called)�selfZ application�request�kwargs�� __class__r r r! � s zWebSocketHandler.__init__c O sB || _ || _| jj�dd��� dkr%| �d� d}| �|� t� |� d S | jj}t dd� |�dd�� d ��}d |vrN| �d� d }| �|� t� |� d S d | jjv r\| jj�d �}n| jj�d d �}|d ur�| � |�s�| �d� d}| �|� t� |� d S | � � | _| jr�| j�� d S | �dd� | �dd� | �� d S )N�Upgrade� � websocket� z"Can "Upgrade" only to "WebSocket".c S s | � � �� S �N)�strip�lower)�sr r r �<lambda>� s z&WebSocketHandler.get.<locals>.<lambda>� Connection�,�upgradez "Connection" must be "Upgrade".ZOriginzSec-Websocket-Origini� z#Cross origin websockets not allowedi� zUpgrade Required�Sec-WebSocket-Versionz7, 8, 13)� open_args� open_kwargsr( �headers�getr2 � set_status�finishr �debug�map�split� check_origin�get_websocket_protocolr" �accept_connection� set_header)r' �argsr) �log_msgr; � connection�originr r r r< � sB � zWebSocketHandler.getNc C � | j �dd�S )zpThe interval for websocket keep-alive pings. Set websocket_ping_interval = 0 to disable pings. Zwebsocket_ping_intervalN�Zsettingsr< �r' r r r � ping_interval� � z WebSocketHandler.ping_intervalc C rJ )z�If no ping is received in this many seconds, close the websocket connection (VPNs, etc. can fail to cleanly close ws connections). Default is max of 3 pings or 30 seconds. Zwebsocket_ping_timeoutNrK rL r r r � ping_timeout� rN z WebSocketHandler.ping_timeoutc C rJ )z�Maximum allowed message size. If the remote peer sends a message larger than this, the connection will be closed. Default is 10MiB. Zwebsocket_max_message_sizeNrK rL r r r �max_message_size� s z!WebSocketHandler.max_message_sizeFc C s4 | j du rt� �t|t�rt�|�}| j j||d�S )an Sends the given message to the client of this Web Socket. The message may be either a string or a dict (which will be encoded as json). If the ``binary`` argument is false, the message will be sent as utf8; in binary mode any byte string is allowed. If the connection is already closed, raises `WebSocketClosedError`. .. versionchanged:: 3.2 `WebSocketClosedError` was added (previously a closed connection would raise an `AttributeError`) .. versionchanged:: 4.3 Returns a `.Future` which can be used for flow control. N)�binary)r" r � isinstance�dict�tornado_escapeZ json_encode� write_message�r' �messagerQ r r r rU � s z WebSocketHandler.write_messagec C � dS )a� Invoked when a new WebSocket requests specific subprotocols. ``subprotocols`` is a list of strings identifying the subprotocols proposed by the client. This method may be overridden to return one of those strings to select it, or ``None`` to not select a subprotocol. Failure to select a subprotocol does not automatically abort the connection, although clients may close the connection if none of their proposed subprotocols was selected. Nr )r' � subprotocolsr r r �select_subprotocol� � z#WebSocketHandler.select_subprotocolc C rX )a� Override to return compression options for the connection. If this method returns None (the default), compression will be disabled. If it returns a dict (even an empty one), it will be enabled. The contents of the dict may be used to control the following compression options: ``compression_level`` specifies the compression level. ``mem_level`` specifies the amount of memory used for the internal compression state. These parameters are documented in details here: https://docs.python.org/3.6/library/zlib.html#zlib.compressobj .. versionadded:: 4.1 .. versionchanged:: 4.5 Added ``compression_level`` and ``mem_level``. Nr rL r r r �get_compression_options s z(WebSocketHandler.get_compression_optionsc O rX )z�Invoked when a new WebSocket is opened. The arguments to `open` are extracted from the `tornado.web.URLSpec` regular expression, just like the arguments to `tornado.web.RequestHandler.get`. Nr �r' rF r) r r r �open$ s zWebSocketHandler.openc C s t �)z�Handle incoming messages on the WebSocket This method must be overridden. .. versionchanged:: 4.5 ``on_message`` can be a coroutine. )�NotImplementedError�r' rW r r r � on_message- s zWebSocketHandler.on_messagec C s | j du rt� �| j �|� dS )z"Send ping frame to the remote end.N)r" r � write_ping�r' �datar r r �ping8 s zWebSocketHandler.pingc C rX )z6Invoked when the response to a ping frame is received.Nr rc r r r �on_pong> � zWebSocketHandler.on_pongc C rX )z*Invoked when the a ping frame is received.Nr rc r r r �on_pingB rg zWebSocketHandler.on_pingc C rX )a` Invoked when the WebSocket is closed. If the connection was closed cleanly and a status code or reason phrase was supplied, these values will be available as the attributes ``self.close_code`` and ``self.close_reason``. .. versionchanged:: 4.0 Added ``close_code`` and ``close_reason`` attributes. Nr rL r r r �on_closeF r[ zWebSocketHandler.on_closec C s" | j r| j �||� d| _ dS dS )aC Closes this Web Socket. Once the close handshake is successful the socket will be closed. ``code`` may be a numeric status code, taken from the values defined in `RFC 6455 section 7.4.1 <https://tools.ietf.org/html/rfc6455#section-7.4.1>`_. ``reason`` may be a textual message about why the connection is closing. These values are made available to the client, but are not otherwise interpreted by the websocket protocol. .. versionchanged:: 4.0 Added the ``code`` and ``reason`` arguments. N)r" �close�r' �code�reasonr r r rj S s �zWebSocketHandler.closec C s, t |�}|j}|�� }| jj�d�}||kS )a� Override to enable support for allowing alternate origins. The ``origin`` argument is the value of the ``Origin`` HTTP header, the url responsible for initiating this request. This method is not called for clients that do not send this header; such requests are always allowed (because all browsers that implement WebSockets support this header, and non-browser clients do not have the same cross-site security concerns). Should return True to accept the request or False to reject it. By default, rejects all requests with an origin on a host other than this one. This is a security protection against cross site scripting attacks on browsers, since WebSockets are allowed to bypass the usual same-origin policies and don't use CORS headers. .. warning:: This is an important security measure; don't disable it without understanding the security implications. In particular, if your authentication is cookie-based, you must either restrict the origins allowed by ``check_origin()`` or implement your own XSRF-like protection for websocket connections. See `these <https://www.christian-schneider.net/CrossSiteWebSocketHijacking.html>`_ `articles <https://devcenter.heroku.com/articles/websocket-security>`_ for more. To accept all cross-origin traffic (which was the default prior to Tornado 4.0), simply override this method to always return true:: def check_origin(self, origin): return True To allow connections from any subdomain of your site, you might do something like:: def check_origin(self, origin): parsed_origin = urllib.parse.urlparse(origin) return parsed_origin.netloc.endswith(".mydomain.com") .. versionadded:: 4.0 �Host)r �netlocr2 r( r; r< )r' rI Z parsed_origin�hostr r r rB g s /z WebSocketHandler.check_originc C s | j �|� dS )a1 Set the no-delay flag for this stream. By default, small messages may be delayed and/or combined to minimize the number of packets sent. This can sometimes cause 200-500ms delays due to the interaction between Nagle's algorithm and TCP delayed ACKs. To reduce this delay (at the expense of possibly increasing bandwidth usage), call ``self.set_nodelay(True)`` once the websocket connection is established. See `.BaseIOStream.set_nodelay` for additional details. .. versionadded:: 3.1 N)r% � set_nodelay)r' �valuer r r rq � s z WebSocketHandler.set_nodelayc C s: | j r | j �� d | _ | jsd| _| �� | �� d S d S �NT)r" �on_connection_closer& ri � _break_cyclesrL r r r rt � s �z$WebSocketHandler.on_connection_closec s( | � � dks | jrtt| ��� d S d S �N�e )Z get_statusr& r r ru rL r* r r ru � s �z WebSocketHandler._break_cyclesc s2 | j d u rtt| �j|i |�� d S | j �� d S r0 )r% r r � send_errorrj r] r* r r rx � s zWebSocketHandler.send_errorc C s* | j j�d�}|dv rt| | �� d�S d S )Nr8 )�7�8�13)�compression_options)r( r; r< �WebSocketProtocol13r\ )r' Zwebsocket_versionr r r rC � s ��z'WebSocketHandler.get_websocket_protocolc C s6 | j j�� | _| j�| j� dD ]}t| |t� qd S )N)�writeZredirectrE Z set_cookier= �flushr> )r( rH �detachr% �set_close_callbackrt �setattr�#_raise_not_supported_for_websockets)r' �methodr r r �_attach_stream� s �z WebSocketHandler._attach_stream�F�NN) r r r r r! � tornado_webZ asynchronousr< r% �propertyrM rO rP rU rZ r\ r^ ra re rf rh ri rj rB rq rt ru rx rC r� � __classcell__r r r* r r = s: P 4 8 r c O s t d��)Nz$Method not supported for Web Sockets)� RuntimeError)rF r) r r r r� � s r� c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) �WebSocketProtocolz0Base class for WebSocket protocol versions. c C s& || _ |j| _|j| _d| _d| _d S r )�handlerr( r% �client_terminated�server_terminated)r' r� r r r r! � s zWebSocketProtocol.__init__c O st z ||i |��}W n t y$ tjdt| jdd�dd� | �� Y dS w |dur8t�|�}| jj � |dd� � |S )z�Runs the given callback with exception handling. If the callback is a coroutine, returns its Future. On error, aborts the websocket connection and returns None. zUncaught exception in %s�pathNT��exc_infoc S s | � � S r0 )�result��fr r r r4 � � z1WebSocketProtocol._run_callback.<locals>.<lambda>) � Exceptionr �error�getattrr( �_abortr Zconvert_yieldedr% �io_loop� add_future)r' �callbackrF r) r� r r r � _run_callback� s �� z WebSocketProtocol._run_callbackc C s | � � d S r0 )r� rL r r r rt � s z%WebSocketProtocol.on_connection_closec C s" d| _ d| _| j�� | �� dS )z?Instantly aborts the WebSocket connection by closing the socketTN)r� r� r% rj rL r r r r� � s zWebSocketProtocol._abortN)r r r r r! r� rt r� r r r r r� � s r� c @ �& e Zd Zddd�Zdd� Zdd� ZdS ) � _PerMessageDeflateCompressorNc C s� |d u rt j}d| krt jksn td|t j��|| _|d u s%d|vr+tjj| _n|d | _|d u s8d|vr<d| _n|d | _|rJ| � � | _ d S d | _ d S )N� �.Invalid max_wbits value %r; allowed range 8-%dZcompression_levelZ mem_level) �zlib� MAX_WBITS� ValueError� _max_wbitsr� ZGZipContentEncodingZ GZIP_LEVEL�_compression_level� _mem_level�_create_compressor� _compressor�r' � persistent� max_wbitsr| r r r r! s � z%_PerMessageDeflateCompressor.__init__c C s t �| jt j| j | j�S r0 )r� � compressobjr� �DEFLATEDr� r� rL r r r r� s z/_PerMessageDeflateCompressor._create_compressorc C s> | j p| �� }|�|�|�tj� }|�d�sJ �|d d� S )N� �����)r� r� �compressr r� � Z_SYNC_FLUSH�endswith)r' rd Z compressorr r r r� ! s � z%_PerMessageDeflateCompressor.compressr0 )r r r r! r� r� r r r r r� s r� c @ r� ) � _PerMessageDeflateDecompressorNc C sV |d u rt j}d| krt jksn td|t j��|| _|r&| �� | _d S d | _d S )Nr� r� )r� r� r� r� �_create_decompressor� _decompressorr� r r r r! * s � z'_PerMessageDeflateDecompressor.__init__c C s t �| j �S r0 )r� � decompressobjr� rL r r r r� 6 s z3_PerMessageDeflateDecompressor._create_decompressorc C s | j p| �� }|�|d �S )Nr� )r� r� � decompress)r' rd Z decompressorr r r r� 9 s z)_PerMessageDeflateDecompressor.decompressr0 )r r r r! r� r� r r r r r� ) s r� c @ s$ e Zd ZdZdZdZdZdZeeB eB ZdZ d@d d �Z d d � Z d d� Z e dd� �Zdd� Zdd� Zdd� Zdd� ZdAdd�ZdAdd �ZdBd d �ZdCd d!�Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Z d.d/� Z d0d1� Z d2d3� Z d4d5� Z dDd6d7�Z!e"d8d9� �Z#e"d:d;� �Z$d<d=� Z%d>d?� Z&dS )Er} z�Implementation of the WebSocket protocol from RFC 6455. This class supports versions 7 and 8 of the protocol in addition to the final version 13. � �@ � � � FNc C s� t �| |� || _d| _d | _d | _d | _d | _d | _d | _ d | _ || _ d | _ d | _ d | _d| _d| _d| _d| _d | _d| _d| _d S )NFr )r� r! � mask_outgoing� _final_frame� _frame_opcode� _masked_frame� _frame_mask� _frame_length�_fragmented_message_buffer�_fragmented_message_opcode�_waiting�_compression_optionsr� r� �_frame_compressed�_message_bytes_in�_message_bytes_out�_wire_bytes_in�_wire_bytes_out� ping_callback� last_ping� last_pong)r' r� r� r| r r r r! L s* z WebSocketProtocol13.__init__c C s� z| � � W n ty# | j�d� d}| j�|� t�|� Y d S w z| �� W d S ty@ tjddd� | �� Y d S w )Nr/ �!Missing/Invalid WebSocket headersz$Malformed WebSocket request receivedTr� ) �_handle_websocket_headersr� r� r= r> r r? �_accept_connectionr� )r' rG r r r rD i s$ � ��z%WebSocketProtocol13.accept_connectionc s& d}t t� fdd�|��std��dS )z�Verifies all invariant- and required headers If a header is missing or have an incorrect value ValueError will be raised )rn �Sec-Websocket-KeyzSec-Websocket-Versionc s � j j�| �S r0 )r( r; r< r� rL r r r4 � s z?WebSocketProtocol13._handle_websocket_headers.<locals>.<lambda>r� N)�allr@ r� )r' �fieldsr rL r r� { s �z-WebSocketProtocol13._handle_websocket_headersc C s2 t �� }|�t| �� |�d� tt�|�� ��S )zoComputes the value for the Sec-WebSocket-Accept header, given the value for Sec-WebSocket-Key. s$ 258EAFA5-E914-47DA-95CA-C5AB0DC85B11)�hashlib�sha1�updater r �base64� b64encode�digest)�keyr� r r r �compute_accept_value� s z(WebSocketProtocol13.compute_accept_valuec C s t �| jj�d��S )Nr� )r} r� r( r; r< rL r r r �_challenge_response� s �z'WebSocketProtocol13._challenge_responsec C st | j j�dd�}dd� |�d�D �}|r)| j�|�}|r)||v s"J �| j�d|� | �| j j�}|D ]9}|d dkrk| jd urk| � d|d | j� d |d v r\|d d d u r\|d d = | j�d t � d|d �� nq2| j� d � | j� d � | j�dd� | j�dd� | j�d| �� � | j�� | j�� | jj| _| �� | j| jjg| jj�R i | jj�� | �� d S )NzSec-WebSocket-Protocolr- c S s g | ]}|� � �qS r )r1 )�.0r3 r r r � <listcomp>� s z:WebSocketProtocol13._accept_connection.<locals>.<listcomp>r6 r �permessage-deflate�server� �client_max_window_bits�Sec-WebSocket-Extensionsz Content-Typerw r, r. r5 zSec-WebSocket-Accept)r( r; r< rA r� rZ rE �_parse_extensions_headerr� �_create_compressorsr Z_encode_headerZ clear_headerr= r� r> r� r% � start_pingingr� r^ r9 r: �_receive_frame)r' rY �selected� extensions�extr r r r� � sF ��� � z&WebSocketProtocol13._accept_connectionc C s( |� dd�}|rdd� |�d�D �S g S )Nr� r- c S s g | ] }t �|�� ��qS r )r Z _parse_headerr1 )r� �er r r r� � s �z@WebSocketProtocol13._parse_extensions_header.<locals>.<listcomp>r6 )r< rA )r' r; r� r r r r� � s �z,WebSocketProtocol13._parse_extensions_headerc C s� |d � � dks J �|d � � dksJ �| �|�}|d |ks!J �| �|�}|D ]}|d dkr>| jdur>| �d |d � q(td |��dS ) z�Process the headers sent by the server to this client connection. 'key' is the websocket handshake challenge/response key. r, r. r5 r7 zSec-Websocket-Acceptr r� N�clientr� zunsupported extension %r)r2 r� r� r� r� r� )r' r� r; �acceptr� r� r r r �_process_server_headers� s �z+WebSocketProtocol13._process_server_headersc C sN t |d |vd�}|�|d d�}|du rtj|d< nt|�|d< ||d< |S )zlConverts a websocket agreed_parameters set to keyword arguments for our compressor objects. Z_no_context_takeover)r� Z_max_window_bitsNr� r| )rS r< r� r� �int)r' �side�agreed_parametersr| �optionsZ wbits_headerr r r �_get_compressor_options� s � z+WebSocketProtocol13._get_compressor_optionsc C sr t g d��}|D ] }||vrtd| ��q|dkrdnd}tdi | �|||���| _tdi | �|||���| _d S )N)Zserver_no_context_takeoverZclient_no_context_takeoverZserver_max_window_bitsr� z$unsupported compression parameter %rr� r� r )�setr� r� r� r� r� r� )r' r� r� r| Z allowed_keysr� Z other_sider r r r� � s � � �z'WebSocketProtocol13._create_compressorsr c C s� |r| j }nd}t�d||B |B �}t|�}| jr d}nd}|dk r-|t�d||B �7 }n|dkr=|t�dd|B |�7 }n |t�dd|B |�7 }| jrWt�d �} | t| |� }||7 }| jt|�7 _z| j � |�W S t yy | � � Y d S w ) Nr �Br� �~ i�� z!BHz!BQ� � ) �FIN�struct�pack�lenr� �os�urandomr r� r% r~ r r� ) r' �fin�opcoderd �flagsZfinbit�frame�lZmask_bit�maskr r r � _write_frame� s. �z WebSocketProtocol13._write_framec C sj |rd}nd}t �|�}t|t�sJ �| jt|�7 _d}| jr,| j�|�}|| jO }| j d|||d�S )z9Sends the given message to the client of this Web Socket.� r� r T)r ) rT r rR �bytesr� r� r� r� �RSV1r )r' rW rQ r r r r r rU s z!WebSocketProtocol13.write_messagec C s t |t�sJ �| �dd|� dS )zSend ping frame.T� N)rR r r rc r r r rb s z WebSocketProtocol13.write_pingc C s4 z | j �d| j� W d S ty | �� Y d S w )Nr )r% � read_bytes�_on_frame_startr r� rL r r r r� ! s �z"WebSocketProtocol13._receive_framec C sZ | j t|�7 _ t�d|�\}}|| j@ | _|| j@ }|| j@ | _| jd@ | _ | j d ur@| jdkr@t || j @ �| _ || j M }|rH| �� d S t |d@ �| _|d@ }| j r`|dkr`| �� d S z>|dk r~|| _| jrv| j�d| j� W d S | �d� W d S |dkr�| j�d | j� W d S |dkr�| j�d| j� W d S W d S ty� | �� Y d S w ) NZBBr� r r� r� r� r� Fr )r� r� r� �unpackr� r� �RSV_MASK� OPCODE_MASKr� �_frame_opcode_is_controlr� �boolr r� r� r� r� r% r �_on_masking_key�_read_frame_data�_on_frame_length_16�_on_frame_length_64r )r' rd �headerZ payloadlenZ reserved_bitsr r r r ' s> � �z#WebSocketProtocol13._on_frame_startc C sd | j }| jd ur|t| j�7 }|| jjpdkr | �dd� d S | j�| j |r,| j� d S | j � d S )Ni � i� zmessage too big) r� r� r� r� rP rj r% r �_on_masked_frame_data�_on_frame_data)r' ZmaskedZnew_lenr r r r I s ��z$WebSocketProtocol13._read_frame_datac C �n | j t|�7 _ t�d|�d | _z| jr!| j�d| j� W d S | � d� W d S t y6 | � � Y d S w )Nz!Hr r� F� r� r� r� r r� r� r% r r r r r� rc r r r r T � �z'WebSocketProtocol13._on_frame_length_16c C r )Nz!Qr r� Fr rc r r r r _ r z'WebSocketProtocol13._on_frame_length_64c C sF | j t|�7 _ || _z| �d� W d S ty" | �� Y d S w rs )r� r� r� r r r� rc r r r r j s �z#WebSocketProtocol13._on_masking_keyc C s | � t| j|�� d S r0 )r r r� rc r r r r r s z)WebSocketProtocol13._on_masked_frame_datac s� d }� j t|�7 _ � jr� js� �� d S � j}n=� jdkr?� jd u r+� �� d S � j|7 _� jr>� j}� j}d � _n� jd urJ� �� d S � jrQ� j}n� j� _|� _� jra� �||�}� j sw|rq|� � fdd�� d S � � � d S d S )Nr c s � � � S r0 )r� )�futurerL r r r4 � r� z4WebSocketProtocol13._on_frame_data.<locals>.<lambda>) r� r� r r� r� r� r� r� �_handle_messager� Zadd_done_callbackr� )r' rd Zhandled_futurer r rL r r v sB � � �z"WebSocketProtocol13._on_frame_datac C s` | j rdS | jr| j�|�}|dkr9| jt|�7 _z|�d�}W n ty0 | �� Y dS w | � | j j |�S |dkrN| jt|�7 _| � | j j |�S |dkr�d| _ t|�dkrit � d|dd� �d | j _t|�dkryt|dd� �| j _| �| j j� dS |d kr�| �dd |� | � | j j|� dS |d kr�t�� �� | _| � | j j|�S | �� dS ) z>Execute on_message, returning its Future if it is a coroutine.Nr� zutf-8r r� T�>Hr r � )r� r� r� r� r� r� �decode�UnicodeDecodeErrorr� r� r� ra r� r r# r r$ rj r rh r �current�timer� rf )r' r rd �decodedr r r r � s< � z#WebSocketProtocol13._handle_messagec C s� | j s3| j�� s0|du r|durd}|du rd}nt�d|�}|dur)|t|�7 }| �dd|� d| _ | jrM| jdurF| jj � | j� d| _| j� � dS | jdu rd| jj � | jj � � d | j�| _dS dS )z Closes the WebSocket connection.N�� � r Tr� � )r� r% �closedr� r� r r r� r� r� �remove_timeoutrj Z add_timeoutr% r� )r' rl rm Z close_datar r r rj � s* ��zWebSocketProtocol13.closec C s | j j}|d ur |S dS )Nr )r� rM )r' �intervalr r r rM � s z!WebSocketProtocol13.ping_intervalc C s$ | j j}|d ur |S td| j d�S )N� � )r� rO �maxrM )r' �timeoutr r r rO � s z WebSocketProtocol13.ping_timeoutc C sD | j dkr t�� �� | _| _t| j| j d �| _| j� � dS dS )z9Start sending periodic pings to keep the connection aliver r' N) rM r r$ r% r� r� r � periodic_pingr� �startrL r r r r� � s ��z!WebSocketProtocol13.start_pingingc C sz | j �� r| jdur| j�� dS t�� �� }|| j }|| j }|d| j k r3|| j kr3| � � dS | � d� || _dS )z�Send a ping to keep the websocket alive Called periodically if the websocket_ping_interval is set and non-zero. Nr r( ) r% r* r� �stopr r$ r% r� r� rM rO rj rb )r' �nowZsince_last_pongZsince_last_pingr r r r1 � s z!WebSocketProtocol13.periodic_ping)FNr0 )r r� r� )'r r r r r� r ZRSV2ZRSV3r r r! rD r� � staticmethodr� r� r� r� r� r� r� r rU rb r� r r r r r r r r rj r� rM rO r� r1 r r r r r} > sP � ) " - ) r} c s� e Zd ZdZ d� fdd� Zddd�Z� fdd�Zd d � Z� fd d �Zd dd�Z d dd�Z dd� Z dd� Z dd� Z dd� Z� ZS ) �WebSocketClientConnectionz�WebSocket client connection. This class should not be instantiated directly; use the `websocket_connect` function instead. Nc s� || _ t� | _d | _d | _t�� | _t� t � d��| _ || _ d | _| _|| _|| _|| _|j�d�\}} } ddd�| }|| | |_|j�dd| j dd �� | j d urZd |jd < t|d �| _tt| ��|d |d d� | j d| jdd� d S )Nr� �:�http�https)�ws�wssr. r, r{ )r, r5 zSec-WebSocket-Keyr8 z*permessage-deflate; client_max_window_bitsr� )r� c S � d S r0 r r r r r r4 < s z4WebSocketClientConnection.__init__.<locals>.<lambda>i @i ) r| r �connect_future�protocol� read_future� collections�deque� read_queuer� r� r r r� �_on_message_callbackr# r$ rM rO rP �url� partitionr; r� r � tcp_clientr r6 r! �_on_http_response) r' r� r( �on_message_callbackr| rM rO rP �scheme�sep�restr* r r r! s8 � � �z"WebSocketClientConnection.__init__c C s& | j dur| j �||� d| _ dS dS )z�Closes the websocket connection. ``code`` and ``reason`` are documented under `WebSocketHandler.close`. .. versionadded:: 3.2 .. versionchanged:: 4.0 Added the ``code`` and ``reason`` arguments. N)r> rj rk r r r rj ? s �z WebSocketClientConnection.closec s> | j �� s | j �t� � | �d � | j�� tt| �� � d S r0 ) r= �done� set_exceptionr ra rF rj r r6 rt rL r* r r rt O s z-WebSocketClientConnection.on_connection_closec C s: | j �� s|jr| j �|j� d S | j �td�� d S d S )NzNon-websocket response)r= rL r� rM r )r' �responser r r rG V s ��z+WebSocketClientConnection._on_http_responsec s� |j dkrtt| ��||�S || _| �� | _| j�| j| j� | j� � | j� � | j d ur8| j � | j � d | _ | j�� | _| j�| j� d | _| j�| � d S rv )rl r r6 �headers_receivedr; rC r> r� r� r� r� �_timeoutr� r+ rH r� r% r� rt Zfinal_callbackr= � set_result)r' Z start_liner; r* r r rO ^ s � z*WebSocketClientConnection.headers_receivedFc C s | j �||�S )z(Sends a message to the WebSocket server.)r> rU rV r r r rU w s z'WebSocketClientConnection.write_messagec C sL | j du sJ �t� }| jr|�| j�� � n|| _ |dur$| j�||� |S )ax Reads a message from the WebSocket server. If on_message_callback was specified at WebSocket initialization, this function will never return messages Returns a future whose result is the message, or None if the connection is closed. If a callback argument is given it will be called with the future when it is ready. N)r? r rB rQ �popleftr� r� )r' r� r r r r � read_message{ s z&WebSocketClientConnection.read_messagec C sD | j r | � |� d S | jd ur| j�|� d | _d S | j�|� d S r0 )rC r? rQ rB �appendr` r r r ra � s z$WebSocketClientConnection.on_messagec C r< r0 r rc r r r rf � � z!WebSocketClientConnection.on_pongc C r< r0 r rc r r r rh � rU z!WebSocketClientConnection.on_pingc C s t | d| jd�S )NT)r� r| )r} r| rL r r r rC � s �z0WebSocketClientConnection.get_websocket_protocol)NNNNNr� r� r0 )r r r r r! rj rt rG rO rU rS ra rf rh rC r� r r r* r r6 s � & r6 c C s� |du rt �� }t| tj�r |du sJ �| } t�| j�| _ntj| |d�} t�| tjj �} t || |||||d�} |durC|� | j |� | j S )a� Client-side websocket support. Takes a url and returns a Future whose result is a `WebSocketClientConnection`. ``compression_options`` is interpreted in the same way as the return value of `.WebSocketHandler.get_compression_options`. The connection supports two styles of operation. In the coroutine style, the application typically calls `~.WebSocketClientConnection.read_message` in a loop:: conn = yield websocket_connect(url) while True: msg = yield conn.read_message() if msg is None: break # Do something with msg In the callback style, pass an ``on_message_callback`` to ``websocket_connect``. In both styles, a message of ``None`` indicates that the connection has been closed. .. versionchanged:: 3.2 Also accepts ``HTTPRequest`` objects in place of urls. .. versionchanged:: 4.1 Added ``compression_options`` and ``on_message_callback``. The ``io_loop`` argument is deprecated. .. versionchanged:: 4.5 Added the ``ping_interval``, ``ping_timeout``, and ``max_message_size`` arguments, which have the same meaning as in `WebSocketHandler`. N)�connect_timeout)rH r| rM rO rP ) r r$ rR r Z HTTPRequestr Z HTTPHeadersr; Z _RequestProxyZ _DEFAULTSr6 r� r= ) rD r� r� rV rH r| rM rO rP r( �connr r r �websocket_connect� s( % ��rX )NNNNNNNN)<r Z __future__r r r r� r@ r� r r� Zsalt.ext.tornado.escaper� Ztornado�escaperT Zsalt.ext.tornado.webZwebr� r� Zsalt.ext.tornado.concurrentr r r r Zsalt.ext.tornador r r Zsalt.ext.tornado.ioloopr r Zsalt.ext.tornado.iostreamr Zsalt.ext.tornado.logr r r Zsalt.ext.tornado.tcpclientr Zsalt.ext.tornado.utilr r � urllib.parser �rangeZxranger� r r ZRequestHandlerr r� �objectr� r� r� r} Z_HTTPConnectionr6 rX r r r r �<module> sX '$ X �
Save