Metadata-Version: 2.1
Name: pysparkplug
Version: 0.3.1
Summary: An open-source, Python implementation of Sparkplug B, an MQTT topic and payload definition standard
Project-URL: Documentation, https://pysparkplug.mattefay.com
Project-URL: Changelog, https://pysparkplug.mattefay.com/en/stable/changelog.html
Project-URL: Source, https://github.com/matteosox/pysparkplug
Project-URL: Bug Tracker, https://github.com/matteosox/pysparkplug/issues
Author-email: Matt Fay <matt.e.fay@gmail.com>
License: Apache License, Version 2.0
License-File: LICENSE
Keywords: automation,manufacturing,mqtt,sparkplug
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Manufacturing
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Requires-Python: >=3.8
Requires-Dist: paho-mqtt<2
Requires-Dist: protobuf
Requires-Dist: typing-extensions; python_version < '3.11'
Description-Content-Type: text/markdown

# **PySparkplug**: Sparkplug B for Python

[![CI/CD: n/a](https://github.com/matteosox/pysparkplug/actions/workflows/cicd.yaml/badge.svg)](https://github.com/matteosox/pysparkplug/actions/workflows/cicd.yaml)
[![Docs: n/a](https://readthedocs.org/projects/pysparkplug/badge/?version=stable)](https://pysparkplug.mattefay.com)
[![Downloads: n/a](https://static.pepy.tech/personalized-badge/pysparkplug?period=total&units=none&left_color=grey&right_color=blue&left_text=Downloads)](https://pepy.tech/project/pysparkplug)
[![PyPI: n/a](https://img.shields.io/badge/dynamic/json?color=blueviolet&label=PyPI&query=%24.info.version&url=https%3A%2F%2Fpypi.org%2Fpypi%2Fpysparkplug%2Fjson)](https://pypi.org/project/pysparkplug/)
[![codecov: n/a](https://codecov.io/gh/matteosox/pysparkplug/branch/main/graph/badge.svg?token=8VKKDG9SMZ)](https://codecov.io/gh/matteosox/pysparkplug)

## Getting Started

### Installation

`pysparkplug` is a pip-installable package [hosted on PyPI](https://pypi.org/project/pysparkplug/). Getting started is as easy as:

```console
$ pip install pysparkplug
```

`pysparkplug` uses the Eclipse Paho™ MQTT Python Client, i.e. [`paho-mqtt`](https://github.com/eclipse/paho.mqtt.python), for low-level MQTT communication.

### Usage

More documentation to come later, but for now, you can find some example usage notebooks in the `notebooks` directory.

## Features

### Fully type annotated

`pysparkplug`'s various interfaces are fully type annotated, passing [Mypy](https://mypy.readthedocs.io/en/stable/)'s static type checker.
