Package: websocket-client-py3
=================websocket-client=================websocket-client module  is WebSocket client for python. This provide the low level APIs for WebSocket. All APIs are the synchronous functions.websocket-client supports only hybi-13.CAUTION============We have a big change on version 0.14.0.So, please test carefully.License============- LGPLInstallation=============This module is tested on Python 2.7 and Python 3.x.Type "python setup.py install" or "pip install websocket-client" to install.This module depend on- six- backports.ssl_match_hostname for Python 2.xHow about Python 3===========================Now, we support python 3 on  single source code from version 0.14.0. Thanks, @battlemidget and @ralphbean.HTTP Proxy=============Support websocket access via http proxy.The proxy server must allow "CONNECT" method to websocket port.Default squid setting is "ALLOWED TO CONNECT ONLY HTTPS PORT".Current implementation of websocket-client is using "CONNECT" method via proxy.Example=============Low Level API example::from websocket import create_connectionws = create_connection("ws://echo.websocket.org/")print "Sending 'Hello, World'..."ws.send("Hello, World")print "Sent"print "Reeiving..."result =  ws.recv()print "Received '%s'" % resultws.close()If you want to customize socket options, set sockopt.sockopt example:from websocket import create_connectionws = create_connection("ws://echo.websocket.org/".sockopt=((socket.IPPROTO_TCP, socket.TCP_NODELAY),) )JavaScript websocket-like API example::import websocketimport threadimport timedef on_message(ws, message):print messagedef on_error(ws, error):print errordef on_close(ws):print "### closed ###"def on_open(ws):def run(*args):for i in range(3):time.sleep(1)ws.send("Hello %d" % i)time.sleep(1)ws.close()print "thread terminating..."thread.start_new_thread(run, ())if __name__ == "__main__":websocket.enableTrace(True)ws = websocket.WebSocketApp("ws://echo.websocket.org/",on_message = on_message,on_error = on_error,on_close = on_close)ws.on_open = on_openws.run_forever()wsdump.py============wsdump.py is simple WebSocket test(debug) tool.sample for echo.websocket.org::$ wsdump.py ws://echo.websocket.org/Press Ctrl+C to quit> Hello, WebSocket< Hello, WebSocket> How are you?< How are you?Usage---------usage::wsdump.py [-h] [-v [VERBOSE]] ws_urlWebSocket Simple Dump Toolpositional arguments:ws_url                websocket url. ex. ws://echo.websocket.org/optional arguments:-h, --help                           show this help message and exitWebSocketApp-v VERBOSE, --verbose VERBOSE    set verbose mode. If set to 1, show opcode. If set to 2, enable to trace websocket moduleexample::$ wsdump.py ws://echo.websocket.org/$ wsdump.py ws://echo.websocket.org/ -v$ wsdump.py ws://echo.websocket.org/ -vvChangeLog============- v0.15.0- fixed exception when send a large message (#84)- v0.14.1- fixed to work on Python2.6 (#83)- v0.14.0- Support python 3(#73)- Support IPv6(#77)- Support explicit web proxy(#57)- specify cookie in connect method option(#82)- v0.13.0- MemoryError when receiving large amount of data (~60 MB) at once(ISSUE#59)- Controlling fragmentation(ISSUE#55)- server certificate validation(ISSUE#56)- PyPI tarball is missing test_websocket.py(ISSUE#65)- Payload length encoding bug(ISSUE#58)- disable Nagle algorithm by default(ISSUE#41)- Better event loop in WebSocketApp(ISSUE#63)- Skip tests that require Internet access by default(ISSUE#66)- v0.12.0- support keep alive for WebSocketApp(ISSUE#34)- fix some SSL bugs(ISSUE#35, #36)- fix "Timing out leaves websocket library in bad state"(ISSUE#37)- fix "WebSocketApp.run_with_no_err() silently eats all exceptions"(ISSUE#38)- WebSocketTimeoutException will be raised for ws/wss timeout(ISSUE#40)- improve wsdump message(ISSUE#42)- support fragmentation message(ISSUE#43)- fix some bugs- v0.11.0- Only log non-normal close status(ISSUE#31)- Fix default Origin isn't URI(ISSUE#32)- fileno support(ISSUE#33)- v0.10.0- allow to set HTTP Header to WebSocketApp(ISSUE#27)- fix typo in pydoc(ISSUE#28)- Passing a socketopt flag to the websocket constructor(ISSUE#29)- websocket.send fails with long data(ISSUE#30)- v0.9.0- allow to set opcode in WebSocketApp.send(ISSUE#25)- allow to modify Origin(ISSUE#26)- v0.8.0- many bug fix- some performance improvement- v0.7.0- fixed problem to read long data.(ISSUE#12)- fix buffer size boundary violation- v0.6.0- Patches: UUID4, self.keep_running, mask_key (ISSUE#11)- add wsdump.py tool- v0.5.2- fix Echo App Demo Throw Error: 'NoneType' object has no attribute 'opcode  (ISSUE#10)- v0.5.1- delete invalid print statement.- v0.5.0- support hybi-13 protocol.- v0.4.1- fix incorrect custom header order(ISSUE#1)