via 1.0.1

An async multi-threaded web framework for people who appreciate simplicity.
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

use std::borrow::Cow;
use std::marker::PhantomData;

use super::query_parser::QueryParser;
use super::{DecodeParam, NoopDecode, Param, PercentDecode};

pub struct QueryParam<'a, 'b, T = NoopDecode> {
    name: &'b str,
    parser: QueryParser<'a>,
    _decode: PhantomData<T>,
}

pub struct QueryParamIter<'a, 'b, T> {
    name: &'b str,
    parser: QueryParser<'a>,
    _decode: PhantomData<T>,
}

fn find_next(parser: &mut QueryParser, name: &str) -> Option<Option<(usize, usize)>> {
    parser.find_map(|(n, at)| if n == name { Some(at) } else { None })
}

impl<'a, 'b, T: DecodeParam> QueryParam<'a, 'b, T> {
    /// Returns a new `QueryParam` that will decode parameter values with
    /// `U::decode` when an individual parameter is converted to a result.
    ///
    pub fn decode<U: DecodeParam>(self) -> QueryParam<'a, 'b, U> {
        QueryParam {
            name: self.name,
            parser: self.parser,
            _decode: PhantomData,
        }
    }

    /// Returns a new `QueryParam` that will percent-decode parameter values
    /// when an individual parameter is converted to a result.
    ///
    pub fn percent_decode(self) -> QueryParam<'a, 'b, PercentDecode> {
        self.decode()
    }

    pub fn exists(mut self) -> bool {
        self.parser.any(|(n, _)| n == self.name)
    }

    pub fn first(mut self) -> Param<'a, 'b, T> {
        let query = self.parser.input();
        let name = self.name;
        let at = find_next(&mut self.parser, name);

        Param::new(at, name, query)
    }

    pub fn last(self) -> Param<'a, 'b, T> {
        let query = self.parser.input();
        let name = self.name;
        let at = self
            .parser
            .filter_map(|(n, at)| if n == name { Some(at) } else { None })
            .last();

        Param::new(at, name, query)
    }
}

impl<'a, 'b, T: DecodeParam> QueryParam<'a, 'b, T> {
    pub(crate) fn new(name: &'b str, query: &'a str) -> Self {
        Self {
            name,
            parser: QueryParser::new(query),
            _decode: PhantomData,
        }
    }
}

impl<'a, T: DecodeParam> Iterator for QueryParamIter<'a, '_, T> {
    type Item = Cow<'a, str>;

    fn next(&mut self) -> Option<Self::Item> {
        let (start, end) = find_next(&mut self.parser, self.name)??;
        let encoded = self.parser.input().get(start..end)?;

        T::decode(encoded).ok()
    }
}

impl<'a, 'b, T: DecodeParam> IntoIterator for QueryParam<'a, 'b, T> {
    type Item = Cow<'a, str>;
    type IntoIter = QueryParamIter<'a, 'b, T>;

    fn into_iter(self) -> Self::IntoIter {
        QueryParamIter {
            name: self.name,
            parser: self.parser,
            _decode: PhantomData,
        }
    }
}