Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (testpypi.python.org).
Help us improve Python packaging - Donate today!

An MQTT client which will send configured MQTT messages to keen IO as events for later analysis.

Project Description

keenmqtt

A MQTT client which will send configured MQTT messages to keen IO as events for later analysis.

The problem

IoT data platforms are often a big investment in time and sometimes money, so often a simple MQTT set up is used. This should not prevent one from being able to perform historical analysis of data points.

The solution

keenmqtt is a simple bridge which will listen for specified MQTT messages and log them on your KeenIO project. This complete history of events will allow you to:

  1. Create graphs of old data, such as temperature.
  2. Use this data to refine your system.
  3. Display this data to your users.

keenmqtt can be run as a standalone daemon, or used in a python program.

Installation

pip install keenmqtt

Or clone/download the repo, run python setup.py install in the root.

Usage

Command Line

Running the stand alone package requires a config file, see example/config.yaml for a template.

After installing, run the following to log events:

keenmqtt -c config.yaml

In your program

keenMQTT has been specifically designed so that almost any part of the pipeline can be overriden or customised.

The source is well documented, take a look in keenmqtt/keenmqtt.py for the good stuff.

Example: Custom payload formats As an example; if you had a sensor which publishes an ascii format sensor reading, you can define a custom payload decoder for topics which match that sensor value as follows:

from keenmqtt import KeenMQTT

class CustomDecoder(KeenMQTT):
    def decode_payload(self, topic, payload):
        """Decode a plain ASCII format sensor reading"""
        if 'humidity' in payload:
            event = {
                "value": int(payload)
            }
        else:
            #Assume default JSON encoding
            event = KeenMQTT.decode_payload(self, topic, payload)
        return event

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request

History

0.0.1: Working version of the CLI app.

Credits

Written by Ben Howes & Richard Webb of Zoetrope

With thanks to:

  1. KeenIO for a super service.
  2. Eclipse Paho for a great MQTT client.

License

MIT Licence

Release History

Release History

This version
History Node

0.0.3

History Node

0.0.2

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
keenmqtt-0.0.3.tar.gz (6.2 kB) Copy SHA256 Checksum SHA256 Source Jul 20, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting