rfc2396 1.1.0

A library for validating strings as RFC2396-compliant URIs
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

/// `"/"  path_segments`
pub fn abs_path(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(nom::bytes::complete::tag("/"), crate::parsers::component::path_segments)(i)
}

/// `reg_name | server`
pub fn authority(i: &str) -> nom::IResult<&str, &str> {
    nom::branch::alt((crate::parsers::multi_char::reg_name, crate::parsers::component::server))(i)
}

/// `alpanum | alphanum *( alphanum | "-" ) alphanum`
pub fn domain_label(i: &str) -> nom::IResult<&str, &str> {
    nom::combinator::recognize(nom::multi::separated_list1(
        nom::multi::many1_count(nom::bytes::complete::tag("-")),
        nom::character::complete::alphanumeric1,
    ))(i)
}

/// `( net_path | abs_path ) [ "?" query ]`
pub fn hier_part(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        nom::branch::alt((crate::parsers::component::net_path, crate::parsers::component::abs_path)),
        nom::combinator::opt(nom::sequence::pair(nom::bytes::complete::tag("?"), crate::parsers::multi_char::query)),
    )(i)
}

/// `hostname | IPv4address`
pub fn host(i: &str) -> nom::IResult<&str, &str> {
    nom::branch::alt((crate::parsers::component::hostname, crate::parsers::component::ipv4_address))(i)
}

/// `*( domainlabel "." ) toplabel [ "." ]`
pub fn hostname(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_tuple((
        nom::multi::many0_count(nom::sequence::tuple((
            crate::parsers::component::domain_label,
            nom::bytes::complete::tag("."),
            nom::combinator::peek(crate::parsers::component::top_label),
        ))),
        crate::parsers::component::top_label,
        nom::combinator::opt(nom::bytes::complete::tag(".")),
    ))(i)
}

/// `host [ ":" port ]`
pub fn host_port(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        crate::parsers::component::host,
        nom::combinator::opt(nom::sequence::pair(nom::bytes::complete::tag(":"), crate::parsers::multi_char::port)),
    )(i)
}

/// `1*digit "." 1*digit "." 1*digit "." 1*digit`
pub fn ipv4_address(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_tuple((
        nom::character::complete::digit1,
        nom::bytes::complete::tag("."),
        nom::character::complete::digit1,
        nom::bytes::complete::tag("."),
        nom::character::complete::digit1,
        nom::bytes::complete::tag("."),
        nom::character::complete::digit1,
    ))(i)
}

/// `"//" authority [ abs_path ]`
pub fn net_path(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_tuple((
        nom::bytes::complete::tag("//"),
        crate::parsers::component::authority,
        nom::combinator::opt(crate::parsers::component::abs_path),
    ))(i)
}

/// `uric_no_slash *uric`
pub fn opaque_part(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_tuple((
        crate::parsers::char::uri_c_no_slash,
        nom::multi::many0_count(crate::parsers::char::uri_c),
    ))(i)
}

/// `segment *( "/" segment )`
pub fn path_segments(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        crate::parsers::component::segment,
        nom::multi::many0_count(nom::sequence::pair(
            nom::bytes::complete::tag("/"),
            crate::parsers::component::segment,
        )),
    )(i)
}

/// `rel_segment [ abs_path ]`
pub fn rel_path(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        crate::parsers::multi_char::rel_segment,
        nom::combinator::opt(crate::parsers::component::abs_path),
    )(i)
}

/// `alpha *( alpha | digit | "+" | "-" | "." )`
pub fn scheme(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        nom::character::complete::satisfy(|c| c.is_ascii_alphabetic()),
        nom::bytes::complete::take_while(|c: char| c.is_ascii_alphanumeric() || matches!(c, '+' | '-' | '.')),
    )(i)
}

/// `*pchar *( ";" param )`
pub fn segment(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        nom::multi::many0_count(crate::parsers::char::p_char),
        nom::multi::many0_count(nom::sequence::pair(nom::bytes::complete::tag(";"), crate::parsers::multi_char::param)),
    )(i)
}

/// `[ [ userinfo "@" ] hostport ]`
pub fn server(i: &str) -> nom::IResult<&str, &str> {
    nom::combinator::recognize(nom::combinator::opt(nom::sequence::pair(
        nom::combinator::opt(nom::sequence::pair(
            crate::parsers::multi_char::user_info,
            nom::bytes::complete::tag("@"),
        )),
        crate::parsers::component::host_port,
    )))(i)
}

/// `alpha | alpha *( alphanum | "-" ) alphanum`
pub fn top_label(i: &str) -> nom::IResult<&str, &str> {
    crate::combinators::recognize_pair(
        nom::combinator::peek(nom::character::complete::satisfy(|c| c.is_ascii_alphabetic())),
        nom::multi::separated_list1(
            nom::multi::many1_count(nom::bytes::complete::tag("-")),
            nom::character::complete::alphanumeric1,
        ),
    )(i)
}

#[cfg(test)]
mod tests;