miko 0.9.0

A web framework for Rust
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

use crate::miko_core::{Req, Resp};
use crate::{AppError, AppResult};
use std::future::Future;
use std::task::{Context, Poll};
use tower::util::BoxCloneService;
use tower::{Layer, Service};

pub struct Next {
    inner: BoxCloneService<Req, Resp, AppError>,
}

impl Next {
    /// Execute the next middleware or handler
    pub async fn run(mut self, req: Req) -> AppResult<Resp> {
        self.inner.call(req).await
    }
}

/// Use async functions as middleware
///
/// # Example
///
/// ```rust,ignore
/// use miko::middleware::{middleware_from_fn, Next};
/// use miko::http::{Req, Resp};
/// use miko::AppResult;
///
/// async fn my_middleware(req: Req, next: Next) -> AppResult<Resp> {
///     println!("Request: {:?}", req);
///     let resp = next.run(req).await?;
///     println!("Response: {:?}", resp);
///     Ok(resp)
/// }
///
/// // app.with_layer(middleware_from_fn(my_middleware));
/// ```
pub fn middleware_from_fn<F>(f: F) -> FromFnLayer<F> {
    FromFnLayer { f }
}

/// Layer created by `from_fn`
#[derive(Clone, Copy)]
pub struct FromFnLayer<F> {
    f: F,
}

impl<S, F> Layer<S> for FromFnLayer<F>
where
    F: Clone,
    S: Service<Req, Response = Resp, Error = AppError> + Clone + Send + 'static,
    S::Future: Send + 'static,
{
    type Service = MiddlewareFromFn<F>;

    fn layer(&self, inner: S) -> Self::Service {
        MiddlewareFromFn {
            f: self.f.clone(),
            inner: BoxCloneService::new(inner),
        }
    }
}

/// Service created by `from_fn`
#[derive(Clone)]
pub struct MiddlewareFromFn<F> {
    f: F,
    inner: BoxCloneService<Req, Resp, AppError>,
}

impl<F, Fut> Service<Req> for MiddlewareFromFn<F>
where
    F: Fn(Req, Next) -> Fut + Clone + Send + Sync + 'static,
    Fut: Future<Output = AppResult<Resp>> + Send + 'static,
{
    type Response = Resp;
    type Error = AppError;
    type Future = Fut;

    fn poll_ready(&mut self, cx: &mut Context<'_>) -> Poll<Result<(), Self::Error>> {
        self.inner.poll_ready(cx)
    }

    fn call(&mut self, req: Req) -> Self::Future {
        let next = Next {
            inner: self.inner.clone(),
        };
        (self.f)(req, next)
    }
}