20 releases (11 breaking)

0.12.0 Mar 13, 2024
0.11.2 Feb 8, 2022
0.11.1 Oct 20, 2021
0.11.0 Mar 29, 2021
0.2.0 Jul 23, 2016

#1424 in Network programming

Download history 57/week @ 2024-12-27 167/week @ 2025-01-03 204/week @ 2025-01-10 189/week @ 2025-01-17 243/week @ 2025-01-24 347/week @ 2025-01-31 207/week @ 2025-02-07 178/week @ 2025-02-14 213/week @ 2025-02-21 235/week @ 2025-02-28 247/week @ 2025-03-07 292/week @ 2025-03-14 272/week @ 2025-03-21 221/week @ 2025-03-28 182/week @ 2025-04-04 228/week @ 2025-04-11

961 downloads per month
Used in 9 crates (4 directly)

MIT/Apache

115KB
2.5K SLoC

MQTT-rs

Build Status Build & Test License crates.io dependency status

MQTT protocol library for Rust

[dependencies]
mqtt-protocol = "0.12"

Usage

extern crate mqtt;

use std::io::Cursor;

use mqtt::{Encodable, Decodable};
use mqtt::packet::{VariablePacket, PublishPacket, QoSWithPacketIdentifier};
use mqtt::TopicName;

fn main() {
    // Create a new Publish packet
    let packet = PublishPacket::new(TopicName::new("mqtt/learning").unwrap(),
                                    QoSWithPacketIdentifier::Level2(10),
                                    "Hello MQTT!");

    // Encode
    let mut buf = Vec::new();
    packet.encode(&mut buf).unwrap();
    println!("Encoded: {:?}", buf);

    // Decode it with known type
    let mut dec_buf = Cursor::new(&buf[..]);
    let decoded = PublishPacket::decode(&mut dec_buf).unwrap();
    println!("Decoded: {:?}", decoded);
    assert_eq!(packet, decoded);

    // Auto decode by the fixed header
    let mut dec_buf = Cursor::new(&buf[..]);
    let auto_decode = VariablePacket::decode(&mut dec_buf).unwrap();
    println!("Variable packet decode: {:?}", auto_decode);
    assert_eq!(VariablePacket::PublishPacket(packet), auto_decode);
}

Note

Dependencies

~0.3–7MB
~40K SLoC