Skip to main content

['Womack pushes real-time javascript events from your application to clients']

Project description

Womack is a service that you can use to push realtime events between your regular, plain-old, non-websockety web application and clients. It is built on top of gevent-socketio and redis.

Why Womack?

You want to write an application, like a game or shared calendar or group chat or some kind of game that involves chatting about calendars in a group. You want the convenience of writing most of your application in the regular, stateless, blocking way you are used to writing web applications, and access to all of the nice tools that you have over in that box. But you also want your calendar game UI to be snappy and realtime and not rely on polling or keeping track of game state in two places. So you put a service like Womack in the middle and use it to push real-time events to clients as your blocking application receives input and does its thing in the database or S3 or wherever.

Quickstart:

  1. Install and start redis

  2. Clone this repository.

  3. Make a virtualenv, then install dependencies with make server

  4. Install Womack: python setup.py develop

  5. Start womack server: womack

  1. In a browser, load http://localhost:8111/test.html

  2. In a python shell, enter:

    >>> import womack.publish
    >>> wm = womack.publish.Publisher()
    >>> wm.publish('hello', {'hello': 'world'})

    You should see the message “hello world” appear immediately in the browser.

Similar projects

Womack was heavily inspired by and includes some client-side code derived from the excellent nodejs project juggernaut and the python client for juggernaut.

Womack has slightly different internal message routing from juggernaut, making it (in our opinion at least) more appropriate for multi-tenant applications. And it is also easier for python programmers to customize, since it is written in python.

About the name

You don’t know what you’ll do until you’re put under pressure

Project details


Download files

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

Source Distribution

womack-0.1.1.tar.gz (59.5 kB view details)

Uploaded Source

File details

Details for the file womack-0.1.1.tar.gz.

File metadata

  • Download URL: womack-0.1.1.tar.gz
  • Upload date:
  • Size: 59.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for womack-0.1.1.tar.gz
Algorithm Hash digest
SHA256 dc1c56ecd719a27212787ae5486a1690986fead6f9bbc6cc4d3ba4e3a4dcd6f0
MD5 5a66a126bb04f274f5d5a041de6831d9
BLAKE2b-256 4f570ca10337f5ab551695af95b9a2c6b71de4144b11dc24d66f7e8a0381ad52

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page