arch-mirrors 0.1.1

Parse the Arch Linux mirror status.
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

//! This is where the [`Protocol`](Protocol) structs and its dependencies go.
use quick_error::quick_error;
use serde::{Deserialize, Serialize};
use std::str::FromStr;

quick_error! {
    /// The possible errors that could happen when working with [`Protocol`](Protocol).
    #[derive(Debug)]
    pub enum Error {
        /// An invalid string was passed to [`Protocol::from_str()`].
        InvalidProtocol(protocol: String) {
            display("can't parse '{}' to a valid protocol", protocol)
        }
    }
}

/// This contains every supported protocol by Arch Linux mirror status as of the time of writing
/// (05/20/2021).
#[derive(Debug, Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Serialize, Deserialize)]
pub enum Protocol {
    /// The HTTP protocol.
    #[serde(rename = "http")]
    Http,

    /// The HTTPS protocol.
    #[serde(rename = "https")]
    Https,

    /// The rsync protocol.
    #[serde(rename = "rsync")]
    Rsync,
}

impl FromStr for Protocol {
    type Err = Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "http" => Ok(Self::Http),
            "https" => Ok(Self::Https),
            "rsync" => Ok(Self::Rsync),
            other => Err(Error::InvalidProtocol(other.into())),
        }
    }
}