Karellen Gevent Websocket Library
Project description
Karellen Gevent Websocket Library
This is a Karellen fork of gevent-websocket. The goal of this fork is to maintain the project to support Python 3.3, 3.4 and 3.5+ as well as latest WS standards errata.
karellen-geventws is a WebSocket library for the gevent networking library.
Features include:
Integration on both socket level or using an abstract interface.
RPC and PubSub framework using WAMP (WebSocket Application Messaging Protocol).
Easily extendible using a simple WebSocket protocol plugin API
from geventwebsocket import WebSocketServer, WebSocketApplication, Resource
class EchoApplication(WebSocketApplication):
def on_open(self):
print("Connection opened")
def on_message(self, message):
self.ws.send(message)
def on_close(self, reason):
print(reason)
WebSocketServer(
('', 8000),
Resource({'/': EchoApplication})
).serve_forever()
or a low level implementation:
from gevent import pywsgi
from geventwebsocket.handler import WebSocketHandler
def websocket_app(environ, start_response):
if environ["PATH_INFO"] == '/echo':
ws = environ["wsgi.websocket"]
message = ws.receive()
ws.send(message)
server = pywsgi.WSGIServer(("", 8000), websocket_app,
handler_class=WebSocketHandler)
server.serve_forever()
More examples can be found in the src/unittest/python directory. Hopefully more documentation will be available soon.
Installation
The easiest way to install karellen-geventws is directly from PyPi using pip or setuptools by running the commands below:
$ pip install karellen-geventws
Gunicorn Worker
Using Gunicorn it is even more easy to start a server. Only the websocket_app from the previous example is required to start the server. Start Gunicorn using the following command and worker class to enable WebSocket funtionality for the application.
gunicorn -k "geventwebsocket.gunicorn.workers.GeventWebSocketWorker" wsgi:websocket_app
Performance
karellen-geventws is pretty fast, but can be accelerated further by installing wsaccel and ujson or simplejson:
$ pip install wsaccel ujson
karellen-geventws automatically detects wsaccel and uses the Cython implementation for UTF8 validation and later also frame masking and demasking.
Get in touch
The fork parent is located at gevent-websocket.
Issues can be created on GitHub.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for karellen-geventws-1.0.2.dev20161215225056.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b11b50c8ce2175f01f137035e664ac89433f6bfa973f583273b74862df6f4791 |
|
MD5 | 770506dd6025f43067829887b01706ca |
|
BLAKE2b-256 | 5873fde8631d026bd37517f15d1096f290e63913f983b7d0f8c0f3c55211b7c8 |
Hashes for karellen_geventws-1.0.2.dev20161215225056-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 02ee073132c2e60a95d1b4af38e08c3539faa0664bd505c51490d642343ce84a |
|
MD5 | 208a6628f6d233cba40695c1160aac9c |
|
BLAKE2b-256 | 51cad11f4e118281feba36d7c9b3ab4aad1790c7bc3ae623860957772c360851 |