rust-mqtt

Crates.iorust-mqtt
lib.rsrust-mqtt
version0.3.0
sourcesrc
created_at2022-04-28 12:30:19.283015
updated_at2024-01-30 09:12:03.978189
descriptionMQTT client for both embedded and non-embedded devices
homepage
repositoryhttps://github.com/obabec/rust-mqtt
max_upload_size
id576767
size319,526
Ulf Lilleengen (lulf)

documentation

README

Rust-mqtt

About

Rust-mqtt is native MQTT client for both std and no_std environments. Client library provides async API which can be used with various executors. Currently, supporting only MQTTv5 but everything is prepared to extend support also for MQTTv3 which is planned during year 2022.

Async executors

For desktop usage I recommend using Tokio async executor and for embedded there is prepared wrapper for Drogue device framework in the Drogue-IoT project examples mqtt module.

Restrains

Client supports following:

  • QoS 0 & QoS 1 (All QoS 2 packets are mapped for future client extension)
  • Only clean session
  • Retain not supported
  • Auth packet not supported
  • Packet size is not limited, it is totally up to user (packet size and buffer sizes have to align)

Building

cargo build

Running tests

Integration tests are written using tokio network tcp stack and can be find under tokio_net.

cargo test unit
cargo test integration
cargo test load

Minimum supported Rust version (MSRV)

Rust-mqtt is guaranteed to compile on stable Rust 1.75 and up. It might compile with older versions but that may change in any new patch release.

Acknowledgment

This project could not be in state in which currently is without Ulf Lilleengen and rest of the community from Drogue IoT.

Contact

For any information contact me on email ond.babec@gmail.com

Commit count: 77

cargo fmt