foxhole 0.4.0

A Blazingly-fast http framework
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

use foxhole::{
    action::Html, connection::Http1, resolve::Get, sys, Action, App, PathIter, Resolve,
    ResolveGuard, Scope,
};

struct Auth {
    #[allow(unused)]
    token: String,
}

impl<'a> Resolve<'a> for Auth {
    type Output = Self;

    fn resolve(ctx: &'a foxhole::RequestState, _path_iter: &mut PathIter) -> ResolveGuard<Self> {
        match ctx.request.headers().get("Authorization") {
            Some(v) => ResolveGuard::Value(Auth {
                token: v.to_str().unwrap().to_string(),
            }),
            None => ResolveGuard::Respond(401u16.action().unwrap()),
        }
    }
}

fn middleware(_auth: Auth) {
    // We could additionally do some extra work here or just use `Auth` on the endpoints like
    // `get_page.
}

fn get_page(_get: Get) -> Html {
    Html("<h1> This page is for authorized personnel only </h1>".to_string())
}

fn main() {
    // ! systems are run from left to right until a response is received from a system
    let scope = Scope::new(sys![middleware]).route("page", sys![get_page]);

    println!("Try connecting on a browser at 'http://localhost:8080/page'");

    App::builder(scope).run::<Http1>("127.0.0.1:5000");
}