PyQTTier

A Python MQTT client library providing a clean, type-safe wrapper around paho-mqtt with support for MQTT 5.0 features.

Features

MQTT 5.0 Support - Full support for MQTT 5.0 protocol features including message properties, correlation data, and response topics
Type Safety - Strongly typed with mypy-checked type hints for reliability
Multiple Transports - Supports TCP, WebSocket, and Unix socket connections
Mock Implementation - Built-in MockConnection for easy testing without a broker
Python 3.7+ - Compatible with Python 3.7 through 3.12

Installation

pip install pyqttier

Quick Start

Basic Usage

from pyqttier.connection import Mqtt5Connection
from pyqttier.transport import MqttTransport, MqttTransportType
from pyqttier.message import Message

# Connect to broker
transport = MqttTransport(
    transport_type=MqttTransportType.TCP,
    host="localhost",
    port=1883,
)
conn = Mqtt5Connection(transport=transport, client_id="my-client")

# Subscribe to a topic
def on_message(msg: Message):
    print(f"Received: {msg.payload.decode()}")

conn.subscribe("sensors/temperature", callback=on_message)

# Publish a message
msg = Message(topic="sensors/temperature", payload=b"23.5", qos=1)
conn.publish(msg)

Testing with MockConnection

from pyqttier.mock import MockConnection
from pyqttier.message import Message

# Create mock connection for testing
conn = MockConnection()

# Publish and verify
result = conn.publish(Message(topic="test", payload=b"data", qos=1))
assert result.done()
assert len(conn.published_messages) == 1
assert conn.published_messages[0].topic == "test"

Examples

See the examples/ directory for more detailed usage examples:

usage_example.py - Real broker connections, wildcards, request-response patterns
mock_example.py - Testing with MockConnection

Development

# Install project
uv pip install -e .

# Type checking
uv run mypy --check-untyped-defs ./src/

# Unit tests
uv run pytest

License

MIT License.

See LICENSE file for details.

Metadata

Release files for pyqttier 0.2.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyqttier 0.2.13
File	Size	Uploaded
pyqttier-0.2.13.tar.gz	73.5 kB	Sep 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pyqttier 0.2.13
File	Interpreter	ABI	Platform	Reset
pyqttier-0.2.13-py3-none-any.whl 12.7 kB Sep 8, 2026	Python 3	none	any	Details

Total release size: 86.2 kB

Release files / pyqttier-0.2.13.tar.gz

Download URL	pyqttier-0.2.13.tar.gz
Size	73.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`c280efa8c6467059c7a587cb5d559f2808302630702b96edde0f493b6b72de1b`
BLAKE2b-256 checksum How to use checksums	`0d443044f8605e7dc212fa2ee8be9a7b5cbc5e0199ca443e948400a308647452`
Upload date	Sep 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / pyqttier-0.2.13-py3-none-any.whl

Download URL	pyqttier-0.2.13-py3-none-any.whl
Size	12.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8265b2faf59bcc2acd62d0e73924caea49fb07914c833340075be9947e64db23`
BLAKE2b-256 checksum How to use checksums	`8d745528cd1aa2d226f1b51865e36bcbd41b2396bcd685803a240cfe550b1c3c`
Upload date	Sep 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`