mini-serve 0.5.0

An HTTP server: trie router, middleware, CORS, optional TLS. Built on hyper + tokio.
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

use std::convert::Infallible;
use std::future::Future;
use std::pin::Pin;
use std::sync::Arc;

use hyper::body::{Bytes, Incoming};
use hyper::{Request, Response};
use http_body_util::combinators::BoxBody;
use http_body_util::Full;

use crate::error::ServeError;
use crate::state::State;

/// The response body type used by all handlers.
pub type ResponseBody = BoxBody<Bytes, Infallible>;

/// Create a response body from raw bytes.
pub fn body(bytes: Bytes) -> ResponseBody {
	BoxBody::new(Full::new(bytes))
}

/// A request handler that processes an HTTP request and returns a response or error.
///
/// Handlers receive the full request (method, path, headers, body) and the app state,
/// and return either a response or a `ServeError` (which is converted to an HTTP error response).
pub type Handler<S> = Arc<
	dyn Fn(Request<Incoming>, State<S>)
			-> Pin<Box<dyn Future<Output = Result<Response<ResponseBody>, ServeError>> + Send>>
		+ Send
		+ Sync,
>;

/// Wrap an async function to create a handler.
///
/// # Example
///
/// ```ignore
/// use mini_serve::handler;
/// use hyper::StatusCode;
/// use hyper::body::Bytes;
///
/// let h = handler(|req, state| async move {
///     Ok::<_, mini_serve::ServeError>(
///         mini_serve::json(StatusCode::OK, &serde_json::json!({"status": "ok"}))
///     )
/// });
/// ```
pub fn handler<S, F, Fut>(f: F) -> Handler<S>
where
	S: Send + Sync + 'static,
	F: Fn(Request<Incoming>, State<S>) -> Fut + Send + Sync + 'static,
	Fut: Future<Output = Result<Response<ResponseBody>, ServeError>> + Send + 'static,
{
	Arc::new(move |req, state| Box::pin(f(req, state)))
}