via-router 1.0.0

A fast and flexible http router.
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

use std::fmt::{self, Debug, Display};
use std::sync::Arc;

use super::SplitPath;

#[derive(PartialEq)]
pub enum Pattern {
    Root,
    Static(Param),
    Dynamic(Param),
    CatchAll(Param),
}

/// An identifier for a named path segment.
///
#[derive(Debug, PartialEq)]
pub struct Param {
    ident: Arc<str>,
}

/// Returns an iterator that yields a `Pattern` for each segment in the uri path.
///
pub fn patterns(path: &'static str) -> impl Iterator<Item = Pattern> {
    SplitPath::new(path).map(|at| {
        let segment = path.get(at.start()..at.end()).unwrap_or("");

        match segment.chars().next() {
            Some(':') => {
                let rest = segment.get(1..).unwrap_or("");
                Pattern::Dynamic(Param::new(rest))
            }
            Some('*') => {
                let rest = segment.get(1..).unwrap_or("");
                Pattern::CatchAll(Param::new(rest))
            }
            _ => {
                // Segment does not contain a dynamic parameter.
                Pattern::Static(Param::new(segment))
            }
        }
    })
}

impl Param {
    pub fn as_str(&self) -> &str {
        &self.ident
    }
}

impl Param {
    pub(crate) fn new(ident: &str) -> Self {
        Self {
            ident: ident.into(),
        }
    }
}

impl Clone for Param {
    fn clone(&self) -> Self {
        Self {
            ident: Arc::clone(&self.ident),
        }
    }
}

impl Display for Param {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        Display::fmt(&self.ident, f)
    }
}