Skip to main content

Tool for generating MQTT messages on various topics

Project description

For testing application and tools which are handling MQTT messages it’s often needed to send continuously messages on random topics to a broker. mqtt-randompub contains options to send a single message, a specific count of messages, or a constant flow of messages till the tool is terminated. Configuration files can be used to store lists of topics to create repeatable test scenarios.

Prerequisites/Installation

Get the files

Clone the mqtt-randompub repository:

git clone git@github.com:fabaff/mqtt-randompub.git

or use pip to make an installation.:

sudo python-pip install mqtt-randompub

Dependencies

mqtt-randompub depends on a couple of additional pieces:

On a Fedora system:

sudo yum -y install mosquitto-python

On Debian and perhaps its downstream Ubuntu (not tested):

sudo apt-get install python-mosquitto_pub

Usage

To run mqtt-randompub just type:

$ mqtt-randompub -h
usage: mqtt-randompub [-h] [-c CONFIG] [-b BROKER] [-p PORT] [-q QOS]
                      [-t TOPIC] [-s SUBTOPIC1] [-d SUBTOPIC2] [-l LOAD]
                      [-i INTERVAL] [-n NUMBER]

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        configuration file to use
  -b BROKER, --broker BROKER
                        set the broker
  -p PORT, --port PORT  set the proker port
  -q QOS, --qos QOS     set the QoS of the messages
  -t TOPIC, --topic TOPIC
                        set the main topic
  -s SUBTOPIC1, --subtopic1 SUBTOPIC1
                        set the first subtopic
  -d SUBTOPIC2, --subtopic2 SUBTOPIC2
                        set the second subtopic
  -l LOAD, --load LOAD  what to use as message payload
  -i INTERVAL, --interval INTERVAL
                        time in seconds between the messages
  -n NUMBER, --number NUMBER
                        number of messages to send. set to 0 for running

in a terminal to see all options. Running without any option will send a sample message to test/# to a broker which listens on localhost on port 1883.

For local testing run a MQTT broker/server on localhost.

  • mosca - A multi-transport MQTT broker for node.js

  • mosquitto - An Open Source MQTT v3.1 Broker

and subscribe to the topic test/# with a MQTT client. For example:

mosquitto_sub -h localhost -d -t test/#

You can run mqtt-randompub with a configuration file to re-use a previous set of topics. Check the mqtt-randompub.example file for details.

License

mqtt-randompub licensed under MIT, for more details check LICENSE.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

mqtt_randompub-0.1.1-py2.7.egg (8.9 kB view details)

Uploaded Source

File details

Details for the file mqtt_randompub-0.1.1-py2.7.egg.

File metadata

  • Download URL: mqtt_randompub-0.1.1-py2.7.egg
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for mqtt_randompub-0.1.1-py2.7.egg
Algorithm Hash digest
SHA256 e9277d170f3156be4d601582225338332dcdc2c0cc7147bdc885a5b134a180ba
MD5 6238e1abacb9962875e385610551ba7d
BLAKE2b-256 1a44c30e4f5c587d17aba2d692109f0e40e44064ee3ddb8df7a85ae37d01cefc

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