lab-ops_lab-lib 0.1.0

Shared types, port allocation, and Docker helpers for the lab-ops workspace
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

//! Transport protocol enum (TCP / UDP).
//!
//! Canonical representation shared across the workspace. Previously defined
//! in natmap's `models.rs`; extracted here so auto-discover can use it without
//! depending on natmap.

use std::fmt::Display;

use serde::Deserialize;
use serde::Serialize;

/// Transport protocol (TCP or UDP).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Hash, Default)]
#[serde(rename_all = "lowercase")]
pub enum TransportProtocol {
    #[default]
    Tcp,
    Udp,
}

impl std::str::FromStr for TransportProtocol {
    type Err = color_eyre::eyre::Error;
    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "tcp" => Ok(Self::Tcp),
            "udp" => Ok(Self::Udp),
            _ => Err(color_eyre::eyre::eyre!("Invalid transport protocol {s}")),
        }
    }
}

impl TransportProtocol {
    /// Returns the lowercase protocol name.
    pub fn to_lowercase(&self) -> &'static str {
        match self {
            Self::Tcp => "tcp",
            Self::Udp => "udp",
        }
    }
}

impl Display for TransportProtocol {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.to_lowercase())
    }
}