This Python package is part of the Eclipse Unide Project and provides an API for generating, parsing and validating PPMP payloads. PPMP, the "Production Performance Management Protocol" is a simple, JSON-based protocol for message payloads in (Industrial) Internet of Things applications defined by the Eclipse IoT Working Group. Implementations for other programming languages are available from the Unide web site.
The focus of the Python implementation is ease of use for backend implementations, tools and for prototyping PPMP applications. Generating a simple payload and sending it over MQTT using Eclipse Paho is a matter of just a few lines:
import unide import paho.mqtt.client as mqtt client = mqtt.Client() client.connect("localhost", 1883, 60) device = unide.Device("Device-001") measurement = device.measurement(temperature=36.7) client.publish(topic="sample", measurement)
The latest version is available in the Python Package Index (PyPI) and can be installed using:
pip install unide-python
unide-python
can be used with Python 2.7, 3.4, 3.5 and 3.6.
Source code, including examples and tests, is available on GitHub: https://github.com/eclipse/unide.python
To install the package from source:
git clone git@github.com:eclipse/unide.python.git cd unide.python python setup.py install
Please refer to CONTRIBUTING.rst
Detailed documentation is available on Read the Docs: http://unidepython.readthedocs.io/en/latest/.