stomp.py
"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:
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.