Examples

You want to reconnect (with a new stream) after the network encountered an error or a disconnect took place!

Smol example:

```rust use mqrstt::{ client::AsyncClient, connectoptions::ConnectOptions, newsmol, packets::{self, Packet}, AsyncEventHandlerMut, HandlerStatus, NetworkStatus, }; use asynctrait::asynctrait; use bytes::Bytes; pub struct PingPong { pub client: AsyncClient, }

[async_trait]

impl AsyncEventHandlerMut for PingPong { // Handlers only get INCOMING packets. This can change later. async fn handle(&mut self, event: &packets::Packet) -> () { match event { Packet::Publish(p) => { if let Ok(payload) = String::fromutf8(p.payload.tovec()) { if payload.tolowercase().contains("ping") { self.client .publish( p.qos, p.retain, p.topic.clone(), Bytes::fromstatic(b"pong"), ) .await .unwrap(); println!("Received Ping, Send pong!"); } } }, Packet::ConnAck() => { println!("Connected!") }, _ => (), } } } smol::blockon(async { let options = ConnectOptions::new("mqrstt".tostring()); let (mut network, mut handler, client) = newsmol(options); let stream = smol::net::TcpStream::connect(("broker.emqx.io", 1883)).await.unwrap(); network.connect(stream).await.unwrap(); client.subscribe("mqrstt").await.unwrap(); let mut pingpong = PingPong { client: client.clone(), }; let (n, h, t) = futures::join!( async { loop { return match network.run().await { Ok(NetworkStatus::Active) => continue, otherwise => otherwise, }; } }, async { loop { return match handler.handlemut(&mut pingpong).await { Ok(HandlerStatus::Active) => continue, otherwise => otherwise, }; } }, async { smol::Timer::after(std::time::Duration::fromsecs(60)).await; client.disconnect().await.unwrap(); } ); assert!(n.isok()); assert!(h.isok()); }); ```

Tokio example:

```rust let options = ConnectOptions::new("TokioTcpPingPong".to_string());

let (mut network, mut handler, client) = new_tokio(options);

let stream = tokio::net::TcpStream::connect(("broker.emqx.io", 1883)) .await .unwrap();

network.connect(stream).await.unwrap();

client.subscribe("mqrstt").await.unwrap();

let mut pingpong = PingPong { client: client.clone(), };

let (n, h, ) = tokio::join!( async { loop { return match network.run().await { Ok(NetworkStatus::Active) => continue, otherwise => otherwise, }; } }, async { loop { return match handler.handlemut(&mut pingpong).await { Ok(HandlerStatus::Active) => continue, otherwise => otherwise, }; } }, async { tokio::time::sleep(Duration::from_secs(60)).await; client.disconnect().await.unwrap(); } ); ```

Important notes:

• Handlers only get incoming packets.

Size

With the smol runtime you can create very small binaries. A simple PingPong smol TCP client can be had for 550\~KB and with TLS you are looking at 1.5\~ MB using the following flags. This makes mqrstt extremely usefull for embedded devices! :) [profile.release] opt-level = "z" # Optimize for size. lto = true codegen-units = 1 strip = true

License

Licensed under

• Mozilla Public License, Version 2.0, (MPL-2.0)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, shall be licensed under MPL-2.0, without any additional terms or conditions.