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

use crate::parse::Error;
use crate::parse::Error::InvalidFragment;
use crate::Fragment;

/// Parses the optional `fragment`.
///
/// The `fragment` must start with a `#` or be empty.
///
/// Returns `Ok(Some(fragment))`.
/// Returns `Ok(None)` if the `fragment` is empty.
/// Returns `Err(InvalidFragment)` if the fragment is invalid.
pub fn parse_fragment(fragment: &str) -> Result<Option<&str>, Error> {
    if fragment.is_empty() {
        Ok(None)
    } else if Fragment::is_valid(fragment) {
        Ok(Some(fragment))
    } else {
        Err(InvalidFragment)
    }
}

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

    #[test]
    fn fn_parse_fragment() {
        let test_cases: &[(&str, Result<Option<&str>, Error>)] = &[
            ("", Ok(None)),
            ("fragment", Err(InvalidFragment)),
            ("#", Ok(Some("#"))),
            ("#fragment", Ok(Some("#fragment"))),
            ("#\x00", Err(InvalidFragment)),
            ("#你好", Err(InvalidFragment)),
            ("#fragment ", Err(InvalidFragment)),
        ];
        for (fragment, expected) in test_cases {
            let result: Result<Option<&str>, Error> = parse_fragment(fragment);
            assert_eq!(result, *expected);
        }
    }
}