“stomp.py” is a Python client library for accessing messaging servers (such as ActiveMQ Classic, ActiveMQ Artemis 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 has officially ended support for Python2.x. 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.connect('admin', 'password', wait=True)
conn.send(body=' '.join(sys.argv[1:]), destination='/queue/test')
conn.disconnect()Documentation and Resources
API documentation (see stomp.github.io for details on the STOMP protocol itself)
A basic example of using stomp.py with a message listener can be found in the quick start section of the main documentation
Description of the command-line interface
The current version of stomp.py supports:
Python 3.x (Python2 support ended as of Jan 2020)
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). This is no longer supported, but (at least as of 2018) there were still a couple of reports of this version still being used in the wild.
Note: stomp.py now follows semantic versioning:
MAJOR version for incompatible API changes,
MINOR version for functionality added in a backwards compatible manner, and
PATCH version for backwards compatible bug fixes.
Testing
stomp.py has been perfunctorily tested on:
Pivotal RabbitMQ (test_rabbitmq.py)
Apache ActiveMQ Classic (test_activemq.py)
Apache ActiveMQ Artemis (test_artemis.py)
For testing locally, you’ll need to install docker (or podman). Once installed:
- Install dependencies:
poetry install
- Create the docker (or podman) image:
make docker-image (or make podman-image)
- Run the container:
make run-docker (or make run-podman)
- Run stomp.py unit tests:
make test
- Cleanup the container afterwards if you don’t need it any more:
make remove-docker (or make remove-podman)
- If you want to connect to the test services locally (other than from the included tests), you’ll want to add test domain names to your hosts file like so:
- 172.17.0.2 my.example.com172.17.0.2 my.example.org172.17.0.2 my.example.net
If you’re using podman and you want to access services via their private IP addresses, you’ll want to run your commands with:
podman unshare --rootless-netns <command>
so that <command> has access to the private container network. Service ports are also exposed to the host and can be accessed directly.
1 maintainer
Release files for stomp.py 9.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| stomp_py-9.0.0.tar.gz | 39.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| stomp_py-9.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 83.9 kB
Release files / stomp_py-9.0.0.tar.gz
| Download URL | stomp_py-9.0.0.tar.gz |
|---|---|
| Size | 39.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
77b63fdd6cb2fb5e3d7032c5e1cde70c005f498d6096b77827efe71913196464
|
|
BLAKE2b-256 checksum How to use checksums |
3f9d2eac45f75ce1f9708cf23c5361e74d0b855013d842d3c0aef64ce0667405
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.4 Linux/7.0.3-1-MANJARO
|
Release files / stomp_py-9.0.0-py3-none-any.whl
| Download URL | stomp_py-9.0.0-py3-none-any.whl |
|---|---|
| Size | 44.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d115c85950b92dad358d11bc361b23d23994d21ff7eef50119f487f718ea4be2
|
|
BLAKE2b-256 checksum How to use checksums |
a599b010daaf1db86ea6ff3b831e70a5484bfe9c4fbf2f5f2ad6578160c56917
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.4 Linux/7.0.3-1-MANJARO
|
