An API for PPMP, the Production Performance Management Protocol
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 firstname.lastname@example.org:eclipse/unide.python.git cd unide.python python setup.py install
This is a straightforward Python project, using setuptools and the standard setup.py mechanism. You can run the test suite using setup.py:
python setup.py 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: http://unidepython.readthedocs.io/en/latest/.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size unide_python-0.1.0-py2.py3-none-any.whl (20.3 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
Hashes for unide_python-0.1.0-py2.py3-none-any.whl