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.12

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.12
File	Size	Uploaded
pyqttier-0.2.12.tar.gz	73.0 kB	Sep 8, 2026	Details

Built distribution (wheel)

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

Total release size: 85.6 kB

Release files / pyqttier-0.2.12.tar.gz

Download URL	pyqttier-0.2.12.tar.gz
Size	73.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`a72c028942a32f1988f6c7e1ce501da9ef77e7304e46fd60075a892f05879b50`
BLAKE2b-256 checksum How to use checksums	`2a3a8ef7027b18ead28e433b7087e2e873d236ef7d1c3d38bf152cb4f5622f07`
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.12-py3-none-any.whl

Download URL	pyqttier-0.2.12-py3-none-any.whl
Size	12.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`12d54fcd86afe432359b9b301931e1eeb4e2903428e025b7bb36b2d762203245`
BLAKE2b-256 checksum How to use checksums	`218f69f4c4340baabd0ec673315de0525316d1548377ebee0000f98f45b2eade`
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}`