Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

This is a transport neutral client implementation of the STOMP protocol.

Project description

Author: Oisin Mulvihill


This is a python client implementation of the STOMP protocol.

The client is attempting to be transport layer neutral. This module provides functions to create and parse STOMP messages in a programatic fashion. The messages can be easily generated and parsed, however its up to the user to do the sending and receiving. The STOMP protocol specification can be found here:

I’ve looked at the stomp client by Jason R. Briggs. I’ve based some of the ‘function to message’ generation on how his client does it. The client can be found at the follow address however it isn’t a dependancy.

In testing this library I run against ActiveMQ project. The server runs in java, however its fairly standalone and easy to set up. The projects page is here:


The unit test “tests/” illustrates how to use all aspects of the code. However if this isn’t y

Basic Usage

Code usage example (see “example/”):

import pprint

import stomper

responder = stomper.Engine()

# Generate the connect command to tell the server about us:
msg = stomper.connect('bob','1234')
print "msg:\n%s\n" % pprint.pformat(msg)

#>>> 'CONNECT\nlogin:bob\npasscode:1234\n\n\x00\n'

# Send the message to the server and you'll get a response like:
server_response = """CONNECTED


# We can react to this using the state machine to generate a response.
# The state machine can handle the raw message:
response = responder.react(server_response)

# or we could unpack the message into a dict and use it:

resp = responder.react(stomper.unpack_frame(response))

# The engine will store the session id from the CONNECTED
# response. It doesn't generate a message response. It
# just returns an empty string.

# After a successfull connect you might want to subscribe
# for messages from a destination and tell the server you'll
# acknowledge all messages.
sub = stomper.subscribe(DESTINATION, ack='client')

# Send the message to the server...

# At some point in the future you'll get messages
# from the server. An example message might be:
server_msg = """MESSAGE
destination: /queue/a
message-id: some-message-id

hello queue a


# We need to acknowledge this so we can pass this message
# into the engine, and by default it will generate and
# ACK message:

response = responder.react(server_msg)
print "response:\n%s\n" % pprint.pformat(response)

#>>> 'ACK\nmessage-id: some-message-id\n\n\x00\n'

# We could over ride the default engine and do more customer
# reaction to receiving messages. For example:

class Pong(stomper.Engine):

    def ack(self, msg):
        """Override this and do some customer message handler.
        print "Got a message:\n%s\n" % msg['body']

        # do something with the message...

        # Generate the ack or not if you subscribed with ack='auto'
        return super(Pong, self).ack(msg)

responder2 = Pong()
response = responder2.react(server_msg)
print "response:\n%s\n" % pprint.pformat(response)
#>>> 'ACK\nmessage-id: some-message-id\n\n\x00\n'

# We might want to send a message at some point. We could do this
# in two ways

# 1. using the the function for send()
send_message = stomper.send(DESTINATION, 'hello there')
print "1. send_message:\n%s\n" % pprint.pformat(send_message)

#>>> 'SEND\ndestination: /queue/inbox\n\nhello there\x00\n'

# 2. using the frame class to add extra custom headers:
msg = stomper.Frame()
msg.cmd = 'MESSAGE'
msg.headers = {'destination:':'/queue/a','message-id:':'some-message-id', 'custom-header' : '1234'}
msg.body = "hello queue a"
print "2. send_message:\n%s\n" % pprint.pformat(msg.pack())

#>>> 'MESSAGE\nmessage-id::some-message-id\ncustom-header:1234\ndestination::/queue/a\n\nhello queue a\n\n\x00\n'

# And thats pretty much it. There are other functions to send various
# messages such as UNSUBSCRIBE, BEGIN, etc. Check out the stomper code
# for further details.


The example “” and “” show how messages and generated and then transmitted using the twisted framework. Other frameworks could be used instead. The examples also demonstrate the state machine I used to determine a response to received messages.

Project details

Download files

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

Files for stomper, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size stomper-0.2.0-py2.4.egg (30.1 kB) File type Egg Python version 2.4 Upload date Hashes View hashes

Supported by

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