sonos-sdk-state 0.8.0

Internal reactive state management for sonos-sdk
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
71
72
73

//! Error types for sonos-state

/// Result type for sonos-state operations
pub type Result<T> = std::result::Result<T, StateError>;

/// Errors that can occur during state management
#[derive(Debug, thiserror::Error)]
pub enum StateError {
    /// Error during initialization
    #[error("Initialization error: {0}")]
    Init(String),

    /// Error parsing data
    #[error("Parse error: {0}")]
    Parse(String),

    /// Error from sonos-api
    #[error("API error: {0}")]
    Api(#[from] sonos_api::ApiError),

    /// State manager is already running
    #[error("State manager is already running")]
    AlreadyRunning,

    /// Shutdown failed
    #[error("Shutdown failed")]
    ShutdownFailed,

    /// Lock acquisition failed
    #[error("Lock error: {0}")]
    LockError(String),

    /// Speaker not found
    #[error("Speaker not found: {0:?}")]
    SpeakerNotFound(crate::model::SpeakerId),

    /// Invalid URL
    #[error("Invalid URL: {0}")]
    InvalidUrl(String),

    /// Initialization failed
    #[error("Initialization failed: {0}")]
    InitializationFailed(String),

    /// Device registration failed
    #[error("Device registration failed: {0}")]
    DeviceRegistrationFailed(String),

    /// Subscription failed
    #[error("Subscription failed: {0}")]
    SubscriptionFailed(String),

    /// Invalid IP address
    #[error("Invalid IP address: {0}")]
    InvalidIpAddress(String),

    /// Lock poisoned (internal mutex error)
    #[error("Internal lock poisoned")]
    LockPoisoned,
}

#[cfg(test)]
mod tests {
    use super::*;
    use std::error::Error as _;

    #[test]
    fn api_variant_keeps_message_and_source() {
        let err = StateError::from(sonos_api::ApiError::NetworkError("boom".to_string()));
        assert_eq!(err.to_string(), "API error: Network error: boom");
        assert!(err.source().is_some());
    }
}