Metadata-Version: 2.1
Name: aedes-mqtt
Version: 0.1.1
Summary: A reliable MQTT publisher for AI runtime environments.
Author-email: Agbropro <nicholasdimas15@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/agbropro/aedes-mqtt
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >3.10
Description-Content-Type: text/markdown
License-File: LICENSE

# aedes-mqtt

A reliable, silent, production-ready MQTT publisher library for Python >3.10, built from paho-mqtt.

## Features

- **Silent by Design**: Contains zero internal logging. All errors are reported via return values or exceptions, giving full control to the consumer.
- **JSON Serialization**: Automatically converts dictionaries to JSON.
- **Dynamic Connection Management**: Enable or disable the publisher at runtime.
- **QoS Support**: Full support for MQTT QoS 0, 1, and 2.
- **Modern Packaging**: Built with `pyproject.toml` and `setuptools`.

## Installation

```bash
pip install aedes-mqtt
```

## Quick Start

The library is silent; ensure you check return values for success/failure.

```python
from aedes_mqtt import MQTTPublisher

# Initialize
publisher = MQTTPublisher(
    broker="localhost",
    port=1883,
    enable=True
)

# Publish a message
data = {"event": "detection", "object": "car"}
success = publisher.publish(topic="ai/tracks", payload=data, qos=1)

if not success:
    print("Publish failed")

# Cleanup
publisher.close()
```

## Requirements

- Python >3.10
- `paho-mqtt==2.1.0`

## License

MIT
