http_uri 1.0.1

This crate provides types for representing http uris and their invariants.
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

//! I define [`PathHasTrailingSlash`] predicate over `HttpUri`.

use std::borrow::Cow;

use gdp_rs::predicate::{Predicate, PurePredicate, SyncEvaluablePredicate};

use crate::HttpUri;

/// A predicate about an [`HttpUri`] asserting that it's path
/// has trailing slash.
#[derive(Debug)]
pub struct PathHasTrailingSlash;

impl Predicate<HttpUri> for PathHasTrailingSlash {
    fn label() -> Cow<'static, str> {
        "PathHasTrailingSlash".into()
    }
}

impl PurePredicate<HttpUri> for PathHasTrailingSlash {}

impl SyncEvaluablePredicate<HttpUri> for PathHasTrailingSlash {
    type EvalError = PathHasNoTrailingSlash;

    #[inline]
    fn evaluate_for(sub: &HttpUri) -> Result<(), Self::EvalError> {
        if sub.path_str().ends_with('/') {
            Ok(())
        } else {
            Err(PathHasNoTrailingSlash)
        }
    }
}

#[derive(Debug, Clone, thiserror::Error, PartialEq, Eq)]
/// Error of HttpUri's path having no trailing slash.
#[error("Given http uri's path has no trailing slash.")]
pub struct PathHasNoTrailingSlash;

#[cfg(test)]
mod tests_evaluation {
    use claims::*;
    use gdp_rs::proven::Proven;
    use rstest::*;

    use super::*;

    #[rstest]
    #[case("http://pod1.example.org/a?")]
    #[case("http://pod1.example.org")]
    #[case("http://pod1.example.org/a?b/")]
    fn uri_sans_path_tslash_will_be_rejected(#[case] uri_str: &'static str) {
        let uri = HttpUri::try_from(uri_str).expect("Claimed valid uri str");
        assert_err_eq!(
            Proven::<_, PathHasTrailingSlash>::try_new(uri).map_err(|e| e.error),
            PathHasNoTrailingSlash
        );
    }

    #[rstest]
    #[case("http://pod1.example.org/a/")]
    #[case("http://pod1.example.org/")]
    #[case::with_fragment("http://pod1.example.org/a/#b/")]
    fn uri_with_path_tslash_will_be_accepted(#[case] uri_str: &'static str) {
        let uri = HttpUri::try_from(uri_str).expect("Claimed valid uri str");
        assert_ok!(Proven::<_, PathHasTrailingSlash>::try_new(uri),);
    }
}