/coilmq

Lightweight Python STOMP message broker.

Primary LanguagePythonApache License 2.0Apache-2.0

CoilMQ

Build Status Coverage Status PyPI downloads

CoilMQ is a simple, configurable STOMP message broker (aka STOMP server) written in Python. This project is inspired by the simple design of the Ruby stompserver project by Patrick Hurley and Lionel Bouton. The goal of this project is to provide a well-tested and well-documented Python implementation with a good set of built-in functionality and numerous paths for extensibility.

Now!

The perferable way to install the CoilMQ is via github, as it will contain the most recent code

$ pip install git+https://github.com/hozn/coilmq.git

But you can also intall it from PyPI

$ pip install CoilMQ

Run CoilMQ

$ coilmq -b 0.0.0.0 -p 61613

Jump over to Getting Started Guide for the slightly longer version.

Current features

  • Support for STOPM v{1.0, 1.1, 1.2}
  • Works on Python {2.7, 3.4, 3.5}
  • {Redis, Memory, RDBM} message store options
  • Extendable via custom components

Status and Goals

The project is currently in beta state and the tip branch in repository should always be considered unstable. Milestones (of varying levels of stability) will be signified by releases.

At a high-level, this project aims to:

  • Provide a correct and functional STOMP implementation
  • Be well documented.
  • Be easy to extend. (e.g. write new auth backend, queue storage)
  • Be well tested.

Take a look at the Roadmap for more details.