tari_common 5.3.0-pre.1

Utilities and features for the Tari domain layer, shared across both Base and Digital Asset layers.
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//  Copyright 2021, The Tari Project
//
//  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
//  following conditions are met:
//
//  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
//  disclaimer.
//
//  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
//  following disclaimer in the documentation and/or other materials provided with the distribution.
//
//  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote
//  products derived from this software without specific prior written permission.
//
//  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
//  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
//  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
//  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
//  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
//  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
//  USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

use std::{
    fmt::{Display, Formatter},
    net::SocketAddr,
    str::FromStr,
};

use anyhow::anyhow;
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, Default)]
pub enum DnsNameServer {
    #[default]
    System,
    Custom {
        addr: SocketAddr,
        dns_name: String,
    },
}

impl DnsNameServer {
    pub fn custom(addr: SocketAddr, dns_name: String) -> Self {
        Self::Custom { addr, dns_name }
    }
}

impl Display for DnsNameServer {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        match self {
            DnsNameServer::System => write!(f, "system"),
            DnsNameServer::Custom { addr, dns_name } => {
                write!(f, "{addr}/{dns_name}")
            },
        }
    }
}

impl FromStr for DnsNameServer {
    type Err = anyhow::Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let s = s
            .to_string()
            .replace(" ", "")
            .replace("\"", "")
            .replace("'", "")
            .to_ascii_lowercase();
        let mut split = s.splitn(2, '/');
        let addr = split
            .next()
            .ok_or_else(|| anyhow!("failed to parse DNS name server 'addr'"))?;
        if addr == "system" {
            return Ok(Self::System);
        }
        let dns_name = split.next().unwrap_or("");
        Ok(Self::Custom {
            addr: addr.parse()?,
            dns_name: dns_name.to_string(),
        })
    }
}

#[cfg(test)]
mod test {
    use std::net::{IpAddr, Ipv4Addr};

    use super::*;

    #[test]
    fn dns_name_server_test() {
        // create dns name server
        let ipv4 = Ipv4Addr::new(127, 0, 0, 1);
        let ip = IpAddr::V4(ipv4);
        let socket = SocketAddr::new(ip, 8080);
        let dns = DnsNameServer::custom(socket, String::from("my_dns"));

        // test formatting
        assert_eq!(format!("{dns}"), "127.0.0.1:8080/my_dns");

        // from str
        let new_dns = DnsNameServer::from_str("'127.0.0.1:8080/my_dns'").unwrap();
        assert_eq!(new_dns, dns);
        let new_dns = DnsNameServer::from_str("\"127.0.0.1:8080/my_dns\"").unwrap();
        assert_eq!(new_dns, dns);
        let new_dns = DnsNameServer::from_str("127.0.0.1:8080/my_dns").unwrap();
        assert_eq!(new_dns, dns);

        // default
        assert_eq!(DnsNameServer::default(), DnsNameServer::System);
    }

    #[test]
    fn to_string_from_str() {
        let ipv4 = Ipv4Addr::new(127, 0, 0, 1);
        let ip = IpAddr::V4(ipv4);
        let socket = SocketAddr::new(ip, 8080);
        let dns = DnsNameServer::custom(socket, String::from("my_dns"));
        let parsed = dns.to_string().parse::<DnsNameServer>().unwrap();
        assert_eq!(dns, parsed);

        let parsed = DnsNameServer::System.to_string().parse::<DnsNameServer>().unwrap();
        assert_eq!(parsed, DnsNameServer::System);
    }
}