Skip to main content

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

Project description

PyPI version

“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.

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 (or podman). Once installed:

  1. Install dependencies:

    poetry install

  2. Create the docker (or podman) image:

    make docker-image (or make podman-image)

  3. Run the container:

    make run-docker (or make run-podman)

  4. Run stomp.py unit tests:

    make test

  5. 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.com
172.17.0.2 my.example.org
172.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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stomp_py-8.2.0.tar.gz (39.3 kB view details)

Uploaded Source

Built Distribution

stomp_py-8.2.0-py3-none-any.whl (42.8 kB view details)

Uploaded Python 3

File details

Details for the file stomp_py-8.2.0.tar.gz.

File metadata

  • Download URL: stomp_py-8.2.0.tar.gz
  • Upload date:
  • Size: 39.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.6 Linux/6.1.112-1-MANJARO

File hashes

Hashes for stomp_py-8.2.0.tar.gz
Algorithm Hash digest
SHA256 9908689361e263bf198e6acfb3c4386759fb7df7d141f4384d7414771c68d7fc
MD5 882cdff1e06d0636f2f1af0f80f14d3c
BLAKE2b-256 bc66c07f01feb5fbc669c4333c76eb02fb8149c653c25ba9769477f8427d5e55

See more details on using hashes here.

File details

Details for the file stomp_py-8.2.0-py3-none-any.whl.

File metadata

  • Download URL: stomp_py-8.2.0-py3-none-any.whl
  • Upload date:
  • Size: 42.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.12.6 Linux/6.1.112-1-MANJARO

File hashes

Hashes for stomp_py-8.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fad24e51b505996015a39ca1632df4e0225c1c552980955e21f2aebfc0d9d85c
MD5 c87c11bfd70e5de4d6a397897cfef187
BLAKE2b-256 7bb6ebfd6daef0c19a5ca3ac1fb2fc092331d67af5a30c868f106fcc2504c287

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page