python-socketio

Python implementation of the Socket.IO realtime server.

Features

Fully compatible with the Javascript, Swift, C++ and Java official Socket.IO clients, plus any third party clients that comply with the Socket.IO specification.
Compatible with Python 2.7 and Python 3.3+.
Supports large number of clients even on modest hardware when used with an asynchronous server based on asyncio (sanic and aiohttp), eventlet or gevent. For development and testing, any WSGI compliant multi-threaded server can also be used.
Includes a WSGI middleware that integrates Socket.IO traffic with standard WSGI applications.
Broadcasting of messages to all connected clients, or to subsets of them assigned to “rooms”.
Optional support for multiple servers, connected through a messaging queue such as Redis or RabbitMQ.
Send messages to clients from external processes, such as Celery workers or auxiliary scripts.
Event-based architecture implemented with decorators that hides the details of the protocol.
Support for HTTP long-polling and WebSocket transports.
Support for XHR2 and XHR browsers.
Support for text and binary messages.
Support for gzip and deflate HTTP compression.
Configurable CORS responses, to avoid cross-origin problems with browsers.

Example

The following example application uses the aiohttp framework for asyncio:

from aiohttp import web
import socketio

sio = socketio.AsyncServer()
app = web.Application()
sio.attach(app)

async def index(request):
    """Serve the client-side application."""
    with open('index.html') as f:
        return web.Response(text=f.read(), content_type='text/html')

@sio.on('connect', namespace='/chat')
def connect(sid, environ):
    print("connect ", sid)

@sio.on('chat message', namespace='/chat')
async def message(sid, data):
    print("message ", data)
    await sio.emit('reply', room=sid)

@sio.on('disconnect', namespace='/chat')
def disconnect(sid):
    print('disconnect ', sid)

app.router.add_static('/static', 'static')
app.router.add_get('/', index)

if __name__ == '__main__':
    web.run_app(app)

And below is a similar example, using Flask to serve the client application. This example is compatible with Python 2.7 and Python 3.3+:

import socketio
import eventlet
import eventlet.wsgi
from flask import Flask, render_template

sio = socketio.Server()
app = Flask(__name__)

@app.route('/')
def index():
    """Serve the client-side application."""
    return render_template('index.html')

@sio.on('connect', namespace='/chat')
def connect(sid, environ):
    print("connect ", sid)

@sio.on('chat message', namespace='/chat')
def message(sid, data):
    print("message ", data)
    sio.emit('reply', room=sid)

@sio.on('disconnect', namespace='/chat')
def disconnect(sid):
    print('disconnect ', sid)

if __name__ == '__main__':
    # wrap Flask application with engineio's middleware
    app = socketio.Middleware(sio, app)

    # deploy as an eventlet WSGI server
    eventlet.wsgi.server(eventlet.listen(('', 8000)), app)

Resources

Release files for python-socketio 1.9.0

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

Source distribution (sdist)

Source distribution for python-socketio 1.9.0
File	Size	Uploaded
python-socketio-1.9.0.tar.gz	24.9 kB	Mar 7, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-socketio 1.9.0
File	Interpreter	ABI	Platform	Reset
python_socketio-1.9.0-py2.py3-none-any.whl 33.3 kB Mar 7, 2018	Python 3, Python 2	none	any	Details

Total release size: 58.2 kB

Release files / python-socketio-1.9.0.tar.gz

Download URL	python-socketio-1.9.0.tar.gz
Size	24.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`71feb10a1b7b410d8f86bbcb0f589c75a32504a01259ed89aa1d7d5dae9190cc`
BLAKE2b-256 checksum How to use checksums	`3794aab2fc3c2f2a5b974b676d8b47f0b630d7dd406aa28437e38ed47250af5c`
Upload date	Mar 7, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / python_socketio-1.9.0-py2.py3-none-any.whl

Download URL	python_socketio-1.9.0-py2.py3-none-any.whl
Size	33.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`93f59452416b00ffd04a4f7d95139235e5eb8876cb090aa939a8e7807fc3ebba`
BLAKE2b-256 checksum How to use checksums	`0f7277145e3a57e35bbd1fafa569c6e5f41a9566077dac324374754cb110e33a`
Upload date	Mar 7, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No