Skip to main content

Distributed message queue based on Redis

Project description

Styx is a simple library that turns a bunch of standalone Redis servers into a powerful distributed queue. The redis servers don’t need any special configuration or even be aware of each other in any way. The messages are loosely ordered. A java version can be found here. The java and python versions are compatible - i.e. messages published by one client can be read by the other client.

Install

pip install styx

Quickstart

#!/usr/bin/env python
# encoding: utf-8

import styx

# Define the Redis host locations (the default port is 6379)
hosts = [ "redis1.example.com", "redis2.example.com:8080", "redis3.example.com" ]

connection = styx.Styx(hosts, db=3) # default db is 0
# If a queue doesn't exist, it will be created automatically
q = connection.get_queue("myTestQueue")
q.put("Hello")
q.put("World")
q.put("Message1234")

q.get() # returns "Hello"
q.get() # returns "World"

# Check how many messages are left in the queue
q.size() # returns 1

# Delete this queue
connection.delete_queue(q)

Unit Tests

To run unit tests, make sure you have 3 redis instances running on localhost at ports 6700, 6701, 6702.

pip install nose
nosetests

Source available on GitHub: http://github.com/abh1nav/styx-python/

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

styx-0.1.2.tar.gz (3.5 kB view details)

Uploaded Source

File details

Details for the file styx-0.1.2.tar.gz.

File metadata

  • Download URL: styx-0.1.2.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for styx-0.1.2.tar.gz
Algorithm Hash digest
SHA256 de57e2c622165cee10e32131a16a0e36be04974e07bcf146384972d8f0181aea
MD5 63cf52666db656dcd9c2040bc6e59941
BLAKE2b-256 a4767e983f644acd9e8f3a99202dbe152357bd09e511ad6c6b47d7dd0b955725

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