Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

redis pubsub websocket proxy

Project Description

socker runs as a single-process service, using asyncio for non-blocking I/O.

socker uses a single redis pubsub channel, and has its own channel subscription logic, this means that you may share redis database with other applications.

socker runs as a single-process service. socker opens up a websocket server port and establishes a redis connection. The redis connection creates a subscription on the socker channel.

Installation

pip install socker

Usage

$ socker -h
Start the socker websocket server

Usage:
  socker [options]
  socker -? | --help
  socker --version

Options:
  -i INTERFACE    Listening interface [default: localhost]
  -p PORT         Listening port [default: 8765]

  -v              Enable verbose output

  --redis-host=HOST             Redis host [default: localhost]
  --redis-port=PORT             Redis port [default: 6379]
  --redis-db=DB                 Redis database [default: 0]
  --redis-password=PASSWORD     Redis password

  --logto FILE    Log output to FILE instead of console

  --version       show version
  -? --help       Show this screen

To publish a message to socker from another application:

from socker import Message


channel = 'foo.bar.42'
data = {
    'yes': [
        'yes',
        'no',
        'baz'
    ]
}

redis_client.publish('socker', Message(channel, data))

Any websocket clients subscribed to

  • foo.*
  • foo.bar.*
  • foo.bar.42

will receive that message.

Releasing a new version to PyPi

  1. Bump the version in VERSION.
  2. Commit the change and tag it with the new version identifier.
  3. Build a source distribution: python setup.py sdist.
  4. Build a wheel: python setup.py bdist_wheel.
  5. Upload the built distribution using Twine: twine upload dist/*.

Release history Release notifications

This version
History Node

2.0.1

History Node

2.0b3

History Node

2.0b2

History Node

2.0b1

History Node

1.2

History Node

1.1.1

History Node

1.1

History Node

1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
socker-2.0.1-py3-none-any.whl (13.7 kB) Copy SHA256 hash SHA256 Wheel py3 Nov 21, 2017
socker-2.0.1.tar.gz (9.1 kB) Copy SHA256 hash SHA256 Source None Nov 21, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page