heos 0.3.1

Rust bindings for HEOS ecosystem API
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

//! Data types that are relevant to [system](crate::command::system) commands.

use qstring::QString;
use serde::{Deserialize, Serialize};
use std::str::FromStr;
use strum::EnumString;

use crate::command::CommandError;
use crate::data::{impl_enum_string_conversions, impl_try_from_response_qs};

/// Whether change events are enabled.
///
/// If change events are enabled, the HEOS system will send unsolicited events for every change that
/// occurs in the system state. These events are represented by data types in the
/// [event module](crate::data::event).
#[derive(Serialize, Deserialize, EnumString, strum::Display, Debug, Clone, Copy, PartialEq, Eq)]
#[serde(into = "String", try_from = "String")]
#[strum(serialize_all = "lowercase")]
pub enum ChangeEventsEnabled {
    /// Change events are enabled, and will be sent by the HEOS system.
    On,
    /// Change events are disabled, and will NOT be sent.
    Off,
}
impl_enum_string_conversions!(ChangeEventsEnabled);

/// Current status of the HEOS system's account.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum AccountStatus {
    /// There is no account currently signed in.
    SignedOut,
    /// There is an account signed in, and it's username is yielded.
    SignedIn(String),
}
impl_try_from_response_qs!(AccountStatus);

impl<'a> TryFrom<&'a QString> for AccountStatus {
    type Error = CommandError;

    fn try_from(qs: &'a QString) -> Result<Self, Self::Error> {
        if qs.get("signed_out").is_some() {
            Ok(Self::SignedOut)
        } else if qs.get("signed_in").is_some() {
            let username = qs.get("un")
                .ok_or(CommandError::response_missing_field("message.un"))?;
            Ok(Self::SignedIn(username.to_string()))
        } else {
            Err(CommandError::response_missing_field("message.signed_out/signed_in"))
        }
    }
}

impl TryFrom<QString> for AccountStatus {
    type Error = CommandError;

    #[inline]
    fn try_from(qs: QString) -> Result<Self, Self::Error> {
        Self::try_from(&qs)
    }
}