https://github.com/zonyitoo/mqtt-rs

MQTT protocol library for Rust
https://github.com/zonyitoo/mqtt-rs

Last synced: 14 days ago
JSON representation

MQTT protocol library for Rust

• Host: GitHub
• URL: https://github.com/zonyitoo/mqtt-rs
• Owner: zonyitoo
• License: mit
• Created: 2015-09-16T07:31:07.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-03-13T14:13:10.000Z (8 months ago)
• Last Synced: 2024-10-23T02:16:23.623Z (21 days ago)
• Language: Rust
• Size: 239 KB
• Stars: 178
• Watchers: 10
• Forks: 38
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# MQTT-rs

[![Build Status](https://img.shields.io/travis/zonyitoo/mqtt-rs.svg)](https://travis-ci.org/zonyitoo/mqtt-rs)

![Build & Test](https://github.com/zonyitoo/mqtt-rs/workflows/Build%20&%20Test/badge.svg)

[![License](https://img.shields.io/github/license/zonyitoo/mqtt-rs.svg)](https://github.com/zonyitoo/mqtt-rs)

[![crates.io](https://img.shields.io/crates/v/mqtt-protocol.svg)](https://crates.io/crates/mqtt-protocol)

[![dependency status](https://deps.rs/repo/github/zonyitoo/mqtt-rs/status.svg)](https://deps.rs/repo/github/zonyitoo/mqtt-rs)

MQTT protocol library for Rust

```toml

[dependencies]

mqtt-protocol = "0.12"

```

## Usage

```rust

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

* Based on [MQTT 3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html)