mdns-proto 0.2.0

Sans-I/O mDNS protocol state machines (no_std, no_alloc capable, panic-free).
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

//! Service lifecycle states (RFC 6762 §8).

use derive_more::{Display, IsVariant, TryUnwrap, Unwrap};

/// Lifecycle state of a registered service.
///
/// Transitions:
///   `Init` → `Probing(0..3)` → `Announcing(0..2)` → `Established`
///   `Probing(_)` -\[conflict\]→ `Conflicting` (caller decides next step)
#[derive(Debug, Display, Copy, Clone, Eq, PartialEq, Hash, IsVariant, Unwrap, TryUnwrap)]
#[display("{}", self.as_str())]
#[non_exhaustive]
pub enum ServiceState {
  /// Just registered; waiting on initial 0–250 ms randomized delay.
  Init,
  /// Probing: probes sent so far (0, 1, or 2 — third probe ends probing).
  Probing(u8),
  /// Announcing: announcements sent so far (0 or 1).
  Announcing(u8),
  /// Established and serving questions; periodically re-announces.
  Established,
  /// Detected a conflict while probing; caller must rename and restart.
  Conflicting,
}

impl ServiceState {
  /// Canonical lowercase slug for this state.
  pub fn as_str(&self) -> &str {
    match self {
      Self::Init => "init",
      Self::Probing(_) => "probing",
      Self::Announcing(_) => "announcing",
      Self::Established => "established",
      Self::Conflicting => "conflicting",
    }
  }
}

#[cfg(test)]
mod tests;