Crate reset_router

A fast RegexSet based router for use with async Hyper (0.13).

Individual handler functions should have the type H, where

    H: Fn(Request) -> F + Sync + Send + 'static,
    F: Future<Output = Result<S, E>> + Send + 'static,
    S: Into<Response>,
    E: Into<Response>

You can return something as simple as Ok(Response::new("hello world".into())). You don't have to worry about futures unless you need to read the request body or interact with other future-aware things.

Usage:

use reset_router::{Request, RequestExtensions, Response, Router};

#[derive(Clone)]
pub struct State(pub i32);

async fn hello(req: Request) -> Result<Response, Response> {
    let (first_name, last_name) = req.parsed_captures::<(String, String)>()?;
    Ok(http::Response::builder()
        .status(200)
        .body(format!("Hello, {} {}!", first_name, last_name).into())
        .unwrap())
}

async fn unreliable_add(req: Request) -> Result<Response, Response> {
    let (add1, add2) = req.parsed_captures::<(i32, i32)>()?;

    let state_num: i32 = req.data::<State>().map(|x| x.0).unwrap_or(0);

    Ok(http::Response::builder()
        .status(200)
        .body(format!("{} + {} = {}\r\n", add1, add2, add1 + add2 + state_num).into())
        .unwrap())
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let router = Router::build()
        .data(State(42))
        .add(http::Method::POST, r"^/hello/([^/]+)/(.+)$", hello)
        .add(http::Method::GET, r"^/hello/([^/]+)/(.+)$", hello)
        .add(http::Method::GET, r"^/add/([\d]+)/([\d]+)$", unreliable_add)
        .finish()?;

    let addr = "0.0.0.0:3000".parse()?;

    let server = hyper::Server::bind(&addr).serve(router);

    server.await?;

    Ok(())
}

Modules

err	Error handling

Structs

Data	Container for application data, available in request handler fns
Router	The router, impls hyper::service::Service and the equivalent of MakeService
RouterBuilder	Builder for a Router

Traits

RequestExtensions

Extensions to http::Request and http::request::Parts to support easy access to captures and State object

Type Definitions

Request	Convenience wrapper for http::Request<hyper::Body>
Response	Convenience wrapper for http::Response<hyper::Body>