web-url 0.10.0

This library aids in processing web-based URLs.
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

use crate::parse::Error;
use crate::Query;

/// Parses the optional query from the prefix of `s`.
///
/// Returns `Ok(optional_query, rest_of_s)`.
/// Returns `Ok(None)` if `s` does not start with a `?`.
/// Returns `Err(InvalidQuery)` if the query is invalid.
#[allow(clippy::type_complexity)]
pub fn parse_query(s: &str) -> Result<(Option<Query<'_>>, &str), Error> {
    if !s.is_empty() && s.as_bytes()[0] == b'?' {
        if let Some(hash) = s.as_bytes().iter().position(|c| *c == b'#') {
            let (query, fragment) = s.split_at(hash);
            let query: Query = Query::try_from(query)?;
            Ok((Some(query), fragment))
        } else {
            let query: Query = Query::try_from(s)?;
            Ok((Some(query), ""))
        }
    } else {
        Ok((None, s))
    }
}

#[cfg(test)]
mod tests {
    use crate::parse::path_plus::parse_query;
    use crate::parse::Error;
    use crate::Query;

    #[test]
    #[allow(clippy::type_complexity)]
    fn fn_parse_query() {
        let test_cases: &[(&str, Result<(Option<Query>, &str), Error>)] = &[
            ("", Ok((None, ""))),
            ("no&start=q", Ok((None, "no&start=q"))),
            ("?", Ok((Some(unsafe { Query::new("?") }), ""))),
            (
                "?the&url=query",
                Ok((Some(unsafe { Query::new("?the&url=query") }), "")),
            ),
            ("#fragment", Ok((None, "#fragment"))),
            (
                "?#fragment",
                Ok((Some(unsafe { Query::new("?") }), "#fragment")),
            ),
            (
                "?the&url=query#fragment",
                Ok((Some(unsafe { Query::new("?the&url=query") }), "#fragment")),
            ),
        ];
        for (s, expected) in test_cases {
            let result: Result<(Option<Query>, &str), Error> = parse_query(s);
            assert_eq!(result, *expected, "s={}", *s);
        }
    }
}