Skip to main content

An API for PPMP, the Production Performance Management Protocol

Project description

Travis-CI badge Coveralls badge Read the Docs

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:

To install the package from source:

git clone
cd unide.python
python install


This is a straightforward Python project, using setuptools and the standard mechanism. You can run the test suite using

python test

There also is a top-level Makefile that builds a development environment and can run a couple of developer tasks. We aim for 100% test coverage and use tox to test against all supported Python releases. To run all tests against all supported Python versions, build the documentation locally and an installable wheel, you’ll require pyenv and a decent implementation of make. make all will create a virtualenv env in the project directory and install the necessary tools (see tools.txt).

For bug reports, suggestions and questions, simply open an issue in the Github issue tracker. We welcome pull requests.


Detailed documentation is available on Read the Docs:

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

unide_python-0.2.0-py2.py3-none-any.whl (25.0 kB view hashes)

Uploaded Python 2 Python 3

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