Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

Metadata

Release files for karellen-geventws 1.0.2.dev20161215225056

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for karellen-geventws 1.0.2.dev20161215225056
File Size Uploaded Provenance Actions
karellen-geventws-1.0.2.dev20161215225056.tar.gz 15.1 kB Without provenance Details for karellen-geventws-1.0.2.dev20161215225056.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for karellen-geventws 1.0.2.dev20161215225056
File Interpreter ABI Platform Actions
karellen_geventws-1.0.2.dev20161215225056-py3-none-any.whl Python 3 none any Details for karellen_geventws-1.0.2.dev20161215225056-py3-none-any.whl

Total release size: 36.8 kB

Release files / karellen-geventws-1.0.2.dev20161215225056.tar.gz

Download URL karellen-geventws-1.0.2.dev20161215225056.tar.gz
Size 15.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b11b50c8ce2175f01f137035e664ac89433f6bfa973f583273b74862df6f4791
BLAKE2b-256 checksum
How to use checksums
5873fde8631d026bd37517f15d1096f290e63913f983b7d0f8c0f3c55211b7c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / karellen_geventws-1.0.2.dev20161215225056-py3-none-any.whl

Download URL karellen_geventws-1.0.2.dev20161215225056-py3-none-any.whl
Size 21.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
02ee073132c2e60a95d1b4af38e08c3539faa0664bd505c51490d642343ce84a
BLAKE2b-256 checksum
How to use checksums
51cad11f4e118281feba36d7c9b3ab4aad1790c7bc3ae623860957772c360851
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for karellen-geventws 1.0.2.dev20161215225056

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page