ebus-homie 0.1.1

Homie 5 protocol core for eBus: identifiers, topics, datatypes, descriptions and the controller and device state machines, with no I/O.
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

//! Registry keys: a device id within a domain, looked up without allocating.

use alloc::sync::Arc;
use core::{borrow::Borrow, cmp::Ordering};

use super::Id;

/// A device in a domain, ordered by id, then domain.
#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
pub(super) struct DevKey {
    pub(super) id: Id,
    pub(super) domain: Arc<str>,
}

/// A borrowed view of a [`DevKey`], so maps keyed by `DevKey` can be searched
/// with `(&str, &str)`.
pub(super) trait KeyRef {
    fn id(&self) -> &str;
    fn domain(&self) -> &str;
}

impl KeyRef for DevKey {
    fn id(&self) -> &str {
        self.id.as_str()
    }
    fn domain(&self) -> &str {
        &self.domain
    }
}

/// `(id, domain)`.
impl KeyRef for (&str, &str) {
    fn id(&self) -> &str {
        self.0
    }
    fn domain(&self) -> &str {
        self.1
    }
}

impl<'a> Borrow<dyn KeyRef + 'a> for DevKey {
    fn borrow(&self) -> &(dyn KeyRef + 'a) {
        self
    }
}

impl PartialEq for dyn KeyRef + '_ {
    fn eq(&self, other: &Self) -> bool {
        self.id() == other.id() && self.domain() == other.domain()
    }
}

impl Eq for dyn KeyRef + '_ {}

impl PartialOrd for dyn KeyRef + '_ {
    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
        Some(self.cmp(other))
    }
}

impl Ord for dyn KeyRef + '_ {
    fn cmp(&self, other: &Self) -> Ordering {
        self.id()
            .cmp(other.id())
            .then_with(|| self.domain().cmp(other.domain()))
    }
}