iriq 0.30.2

IRI/URL extraction, normalization, and shape clustering.
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

use crate::ordered_map::OrderedMap;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Kind {
    Url,
    Urn,
}

impl Kind {
    pub fn as_str(&self) -> &'static str {
        match self {
            Kind::Url => "url",
            Kind::Urn => "urn",
        }
    }
}

/// Parsed IRI. For URN-style inputs only Scheme + NSS are populated;
/// Host/Path are empty.
#[derive(Debug, Clone)]
pub struct Identifier {
    pub original: String,
    pub scheme: String,
    pub host: String,
    pub port: u16, // 0 == unset
    pub path: String,
    pub path_segments: Vec<String>,
    pub query: String,
    pub query_params: OrderedMap,
    pub fragment: String,
    pub nss: String,
    pub kind: Kind,
}

impl Identifier {
    pub fn is_urn(&self) -> bool {
        self.kind == Kind::Urn
    }

    pub fn is_url(&self) -> bool {
        self.kind == Kind::Url
    }

    /// Rebuild an IRI-like string from the parsed fields. Preserves
    /// Unicode display form (no punycode / percent-encoding pass).
    pub fn canonical(&self) -> String {
        if self.is_urn() {
            return format!("urn:{}", self.nss);
        }
        let mut s = String::new();
        if !self.scheme.is_empty() {
            s.push_str(&self.scheme);
            s.push_str("://");
        }
        if !self.host.is_empty() {
            s.push_str(&self.host);
        }
        if self.port != 0 {
            s.push(':');
            s.push_str(&self.port.to_string());
        }
        let has_query = !self.query.is_empty();
        let has_frag = !self.fragment.is_empty();
        if !self.path_segments.is_empty() {
            s.push('/');
            s.push_str(&self.path_segments.join("/"));
        } else if has_query || has_frag {
            s.push('/');
        }
        if has_query {
            s.push('?');
            s.push_str(&self.query);
        }
        if has_frag {
            s.push('#');
            s.push_str(&self.fragment);
        }
        s
    }

    pub fn equals(&self, other: &Identifier) -> bool {
        self.canonical() == other.canonical()
    }
}

impl std::fmt::Display for Identifier {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(&self.canonical())
    }
}