bluez-async 0.8.2

An async wrapper around the D-Bus interface of BlueZ (the Linux Bluetooth daemon), supporting GATT client (central) functionality.
Documentation
use std::convert::TryInto;
use std::fmt::{self, Debug, Display, Formatter, LowerHex, UpperHex};
use std::str::FromStr;
use thiserror::Error;

/// An error parsing a MAC address from a string.
#[derive(Clone, Debug, Error, Eq, PartialEq)]
#[error("Invalid MAC address '{0}'")]
pub struct ParseMacAddressError(String);

/// MAC address of a Bluetooth device.
#[derive(Clone, Copy, Eq, Hash, Ord, PartialEq, PartialOrd)]
pub struct MacAddress([u8; 6]);

impl Display for MacAddress {
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        UpperHex::fmt(self, f)
    }
}

impl Debug for MacAddress {
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        UpperHex::fmt(self, f)
    }
}

impl UpperHex for MacAddress {
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        write!(
            f,
            "{:02X}:{:02X}:{:02X}:{:02X}:{:02X}:{:02X}",
            self.0[0], self.0[1], self.0[2], self.0[3], self.0[4], self.0[5]
        )
    }
}

impl LowerHex for MacAddress {
    fn fmt(&self, f: &mut Formatter) -> fmt::Result {
        write!(
            f,
            "{:02x}:{:02x}:{:02x}:{:02x}:{:02x}:{:02x}",
            self.0[0], self.0[1], self.0[2], self.0[3], self.0[4], self.0[5]
        )
    }
}

impl FromStr for MacAddress {
    type Err = ParseMacAddressError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(MacAddress(
            s.split(':')
                .map(|octet| {
                    if octet.len() != 2 {
                        Err(ParseMacAddressError(s.to_string()))
                    } else {
                        u8::from_str_radix(octet, 16)
                            .map_err(|_| ParseMacAddressError(s.to_string()))
                    }
                })
                .collect::<Result<Vec<u8>, _>>()?
                .try_into()
                .map_err(|_| ParseMacAddressError(s.to_string()))?,
        ))
    }
}

impl From<[u8; 6]> for MacAddress {
    fn from(octets: [u8; 6]) -> Self {
        MacAddress(octets)
    }
}

impl From<MacAddress> for [u8; 6] {
    fn from(mac_address: MacAddress) -> Self {
        mac_address.0
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn from_str() {
        assert_eq!(
            "11:22:33:44:55:66".parse(),
            Ok(MacAddress([0x11, 0x22, 0x33, 0x44, 0x55, 0x66]))
        );
        assert_eq!(
            "ab:cd:ef:44:55:66".parse(),
            Ok(MacAddress([0xab, 0xcd, 0xef, 0x44, 0x55, 0x66]))
        );
        assert_eq!(
            "AB:CD:EF:44:55:66".parse(),
            Ok(MacAddress([0xab, 0xcd, 0xef, 0x44, 0x55, 0x66]))
        );
    }

    #[test]
    fn from_str_invalid() {
        assert_eq!(
            MacAddress::from_str(""),
            Err(ParseMacAddressError("".to_string()))
        );
        assert_eq!(
            MacAddress::from_str("11:22:33:44:55"),
            Err(ParseMacAddressError("11:22:33:44:55".to_string()))
        );
        assert_eq!(
            MacAddress::from_str("11:22:33:44:55:66:77"),
            Err(ParseMacAddressError("11:22:33:44:55:66:77".to_string()))
        );
        assert_eq!(
            MacAddress::from_str("11:22:33:44:555:6"),
            Err(ParseMacAddressError("11:22:33:44:555:6".to_string()))
        );
        assert_eq!(
            MacAddress::from_str("1g:22:33:44:55:66"),
            Err(ParseMacAddressError("1g:22:33:44:55:66".to_string()))
        );
    }

    #[test]
    fn to_string() {
        assert_eq!(
            MacAddress([0x11, 0x22, 0x33, 0x44, 0x55, 0x66]).to_string(),
            "11:22:33:44:55:66"
        );
        assert_eq!(
            MacAddress([0xab, 0xcd, 0xef, 0x44, 0x55, 0x66]).to_string(),
            "AB:CD:EF:44:55:66"
        );
    }

    #[test]
    fn format() {
        let mac_address = MacAddress([0x12, 0x34, 0x56, 0xab, 0xcd, 0xef]);

        assert_eq!(format!("{}", mac_address), "12:34:56:AB:CD:EF");
        assert_eq!(format!("{:X}", mac_address), "12:34:56:AB:CD:EF");
        assert_eq!(format!("{:x}", mac_address), "12:34:56:ab:cd:ef");
    }
}