Skip to main content

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

Project description

PyPI version Build Status

“stomp.py” is a Python client library for accessing messaging servers (such as 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.

If you find this project useful, why not buy me a coffee.

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

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:

For testing locally, you’ll need to install docker. Once installed:

  1. Create the docker image:
    make docker-image
  2. Run the container:
    make run-docker
  3. Run stomp.py unit tests:
    make test
  4. Cleanup the container afterwards if you don’t need it any more:
    make remove-docker

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 stomp.py, version 6.1.0
Filename, size File type Python version Upload date Hashes
Filename, size stomp.py-6.1.0-py3-none-any.whl (37.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size stomp.py-6.1.0.tar.gz (34.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page