Redis-over-WebSocket API on top of websockets and aioredis
Project description
An extensible Redis-over-WebSocket API on top of websockets and aioredis.
Installation
For basic functionality:
pip install redis_websocket_api
With geo extension (filtering messages by extent, projection transformation):
pip install redis_websocket_api[geo]
Server-Side Usage
Start the WebsocketServer
like this:
from aioredis import create_redis_pool
from redis_websocket_api import WebsocketServer
REDIS_ADDRESS = ('localhost', 6379)
WebsocketServer(
redis=loop.run_until_complete(create_redis_pool(REDIS_ADDRESS)),
subscriber=loop.run_until_complete(create_redis_pool(REDIS_ADDRESS)),
read_timeout=30,
keep_alive_timeout=120,
).listen(
host='localhost',
port=8000,
channel_names=('public_channel_1', 'public_channel_2'),
)
Have a look at examples/demo.py
for an example with the GeoCommandsMixin
added.
Clint-Side Usage
WebsocketHandler
The default functionality provides the following interface to the web client (expecting the requests over a websocket connection):
GET key
translates tohvals key
GET key hkey
translates tohget key hkey
SUB key
subscribes the websocket to a redis channel (using a single redis connection pool for all clients)DEL key
unsubscribes the client from the channelPING
causes aPONG
response (to avoid timeouts)
Subclass of WebsocketHandler
with GeoCommandsMixin
added
By adding the GeoCommandsMixin
the web client can use
BBOX left bottom right top
to only receive GeoJSON features within this box plus all messages which are not valid GeoJSONPROJECTION epsg:number
causes all future GeoJSON features to be transformed to the given projection
See examples/demo.py
for how to use an extended WebsocketHandler
subclass.
Geo commands are currently limited to LineString
, Polygon
, and Point
geometries.
Build your own protocol
Using the commands listed above for communicating from client to server is
completly optional and determinded by the Mixin classes added to the
WebsocketHandlerBase
.
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 redis-websocket-api-0.0.2.post2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | ffba522e6f85f382bdb46514522d30bdc5436b2ec5a5c0dc458b10d9e0fd9104 |
|
MD5 | 2f6af17055b3098f21e09e3dcf7ff4dc |
|
BLAKE2b-256 | 2f48446ef1950f148fb4a96dadc2ac52cfd016a9e78574fedbae499c7434cac6 |
Hashes for redis_websocket_api-0.0.2.post2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f6fa665cf880db91df0df0df6ea2a60e1c69255e7bd89e05ce01f134f75a6d2c |
|
MD5 | 67170fa95c1cffa5e87c8e76cd54db75 |
|
BLAKE2b-256 | 0291fd2b5d867ed4f4e78f483891803b806eac47cb1a76d85232a93978f9b196 |