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

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.11
File	Size	Uploaded
pyqttier-0.2.11.tar.gz	70.5 kB	Sep 4, 2026	Details

Built distribution (wheel)

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

Total release size: 81.8 kB

Release files / pyqttier-0.2.11.tar.gz

Download URL	pyqttier-0.2.11.tar.gz
Size	70.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`9a121c352d4eab188c8af89652dde0d1922cdbf2c49ffe33f241d5103d03ded5`
BLAKE2b-256 checksum How to use checksums	`1172b4d6cdbf0e0e6baf64601f2c8537139aa6719d2c814a51ca15258e1fa061`
Upload date	Sep 4, 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.11-py3-none-any.whl

Download URL	pyqttier-0.2.11-py3-none-any.whl
Size	11.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4632892adb58c75c267264c52399ea94280ad6b1cd0a94ab3759b5dc632fd262`
BLAKE2b-256 checksum How to use checksums	`fbfb88598e84fe13d60d49cecb28e729995034e28161a06c2df5de031ac5af47`
Upload date	Sep 4, 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}`