Ferrum Router

Routing handler for the Ferrum web framework.

Ferrum Router is a fast, convenient, and flexible routing middleware for Ferrum. It allows complex glob patterns and named url parameters and also allows handlers to be any Handler, including all Chains.

Example

```rust extern crate ferrum; extern crate ferrum_router;

use ferrum::*; use ferrum_router::Router;

fn main() { let mut router = Router::new(); // Alternative syntax: router.get("/", handler, "index"); // let router = router!(index: get "/" => handler, router.get("/{query}", handler, "query"); // query: get "/{query}" => handler);

Ferrum::new(router).http("localhost:3000").unwrap();

fn handler(request: &mut Request) -> FerrumResult<Response> {
    let params = request.extensions.get::<Router>().unwrap();
    let query = params.get("query").map(|value| value.as_str()).unwrap_or("/");
    Ok(Response::new().with_content(query, mime::TEXT_PLAIN))
}

} ```

Overview

Router is a part of Ferrum's core bundle.

• Route client requests based on their paths
• Parse parameters and provide them to other middleware/handlers

Installation

If you're using cargo, just add ferrum-router to your Cargo.toml.

```toml [dependencies]

ferrum-router = "*" ```

Otherwise, cargo build, and the rlib will be in your target directory.

Examples

Check out the examples directory!

You can run an individual example using cargo run --example example-name. Note that for benchmarking you should make sure to use the --release flag, which will cause cargo to compile the entire toolchain with optimizations. Without --release you will get truly sad numbers.

Benches

To run benchmark tests, please use Rust nightly toolchain:

rustup default nightly cargo bench --features "nightly"

License

MIT