stomp.py 4.1.21

Python STOMP client, supporting versions 1.0, 1.1 and 1.2 of the protocol

“stomp.py” is a Python client library for accessing messaging servers (such as ActiveMQ, Apollo or RabbitMQ) using the STOMP protocol (STOMP v1.0, STOMP v1.1 and STOMP v1.2). It can also be run as a standalone, command-line client for testing.

NOTE: Stomp.py is officially ending support for Python2.x by Jan 2020. See python3statement.org for more information.

Quick Start

You can connect to a message broker running on the local machine, and send a message using the following example.

import stomp

conn = stomp.Connection()
conn.set_listener('', MyListener())
conn.start()
conn.connect('admin', 'password', wait=True)
conn.send(body=' '.join(sys.argv[1:]), destination='/queue/test')
conn.disconnect()

Various documentation and resources include:

• basic example of using stomp.py with a message listener

• command-line interface description

• installation instructions and downloads on PyPi stomp.py page

• API documentation

• current test coverage report

• travis continuous integration

Current version supports:

• Python 2.x and 3.x

• STOMP version 1.0, 1.1 and 1.2

There is also legacy 3.1.7 version using the old 3-series code (see 3.1.7 on PyPi and 3.1.7 on GitHub).

stomp.py has been perfunctorily tested on:

• ActiveMQ

• Apollo

• RabbitMQ

• stompserver

stomp.py has been reported to work with JBossMessaging in the distant past.

For more info on setting up a test server (using virtualbox), contact the developer.