“stomp.py” is a Python client library for accessing messaging servers (such as Apollo or RabbitMQ) using the STOMP protocol (versions 1.0, 1.1 and 1.2). It can also be run as a standalone, command-line client for testing.
Python Makefile
Clone or download
jasonrbriggs Merge pull request #213 from scop/test-update
Test with Python 3.6 on Travis
Latest commit a1e178b Aug 12, 2018

README.rst

stomp.py

PyPI version Build Status

"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:

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:

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.