masaka 0.1.0

A highly modular, no-std async MQTT client
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

#![cfg_attr(not(feature = "std"), no_std)]

extern crate alloc;

#[cfg(not(any(feature = "tokio", feature = "embassy")))]
compile_error!("A runtime feature must be enabled. Available: 'tokio', 'embassy'. 'embassy' is enabled by default.");

pub mod client;
pub mod config;
pub mod error;
pub mod protocol;
pub mod session;
pub mod state;
pub mod time;
pub mod transport;

// Re-export core types from mqtt-proto
pub use mqtt_proto::{Pid, Protocol, QoS, TopicFilter, TopicName};

// Re-export main client types
pub use client::{ClientEvent, MqttClient};

// Re-export configuration types
pub use config::{
    ClientConfig, ProtocolConfig, PublishConfig, ReconnectConfig, TransportConfig, V5ConnectConfig,
    V5PublishConfig, V5SubscribeConfig, WillMessage,
};

// Re-export error types
pub use error::{ConfigError, MqttError, ProtocolError, SessionError, TransportError};

// Re-export protocol handlers and types
pub use protocol::{MqttProtocolHandler, PacketAction, V3Handler, V5Handler};

// Re-export time provider
pub use time::TimeProvider;

// Re-export transport trait
pub use transport::MqttTransport;

// Convenience macros
/// Create a `TopicName` from a string literal.
///
/// # Example
///
/// ```rust
/// use masaka::topic;
/// let topic = topic!("sensors/temperature");
/// ```
#[macro_export]
macro_rules! topic {
    ($topic:expr) => {
        $crate::TopicName::try_from($topic).expect("Invalid topic name")
    };
}

/// Create a `TopicFilter` from a string literal.
///
/// # Example
///
/// ```rust
/// use masaka::topic_filter;
/// let filter = topic_filter!("sensors/+/temperature");
/// ```
#[macro_export]
macro_rules! topic_filter {
    ($filter:expr) => {
        $crate::TopicFilter::try_from($filter).expect("Invalid topic filter")
    };
}