vintage 0.2.0

A multi-threaded FastCGI server
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

use crate::record::{Params, Stdin};

/// A request from a FastCGI client.
///
/// Common [request metavariables](https://datatracker.ietf.org/doc/html/rfc3875#section-4.1) can be retrieved using the similarly named functions.
/// These functions return `None` when the header has no value or if its value is the empty string.
///
/// Note that the presence/absence of these metavariables is dependent on the FastCGI client.
/// The FastCGI client might also forward HTTP headers prefixed with `HTTP_*`.
/// Use [`Request::get`] to access such metavariables for which a dedicated method does not
/// exist.
#[derive(Debug, Clone)]
pub struct Request {
    pub(crate) vars: Params,
    pub(crate) body: Stdin,
}

impl Request {
    impl_meta![
        AUTH_TYPE :: "Returns the mechanism used by the server to authenticate the user, if any.",
        CONTENT_LENGTH :: "Returns the size of the message body attached to the request, if any.",
        CONTENT_TYPE :: "Returns the media type of the request body if it exists.",
        GATEWAY_INTERFACE :: "Returns the CGI version being used.",
        PATH_INFO :: "Returns the path requested.",
        QUERY_STRING :: "Returns the URL-encoded search or parameter string.",
        REMOTE_ADDR :: "Returns the address of the client sending the request.",
        REMOTE_HOST :: "Returns the fully qualified address of the client sending the request.",
        REMOTE_USER :: "Returns the user identification string supplied by the client as part of user authentication.",
        REQUEST_METHOD :: "Returns the request method used.",
        SERVER_NAME :: "Returns the name of the server to which this request was directed.",
        SERVER_PORT :: "Returns the TCP/IP port on which this request was received",
        SERVER_PROTOCOL :: "Returns the name and version of the application protocol used for this request",
        SERVER_SOFTWARE :: "Returns the name and version of the FastCGI client"
    ];

    /// Returns the value of the CGI meta-variable `name`, if it exists
    pub fn get(&self, name: &str) -> Option<&str> {
        let res = self.vars.get(name);
        if let Some("") = res {
            return None;
        }
        res
    }

    /// Returns the body of the request.
    ///
    /// The returned `Vec` will be empty if the request had no body.
    /// If there was a body, note that subsequent invocations will return an empty `Vec`.
    pub fn read_body(&mut self) -> Vec<u8> {
        self.body.take()
    }
}

macro_rules! impl_meta {
    ($($name:ident :: $doc:literal),*) => {
        $(
        paste::paste! {
            #[doc = $doc]
            pub fn [<get_$name:lower>](&self) -> Option<&str> {
                self.get(stringify!($name))
            }

        }
        )*
    };
}
pub(crate) use impl_meta;