rs-regex-router
An implementation of request routing via a singular grouped regex (with support for path parameter extraction).
Features
- Design approach based upon this article.
- Implemented over a generic handler type allowing use with varying webserver crates.
- Extraction of path parameters which are then mapped as key/value pairs.
- Convenience macros for easily declaring routes and obtaining path parameter values.
Installation & Basic Usage
[dependencies]
regex_router = "1.0.0"
An example using a unit handler type:
use regex_router::{RouterBuilder, route};
...
let mut builder = RouterBuilder::<()>::new();
route!(builder; r"/example";; "GET" => ());
route!(builder; r"/test";; "GET" => ());
let router = builder.build().unwrap();
An example declaring path parameters:
let mut builder = RouterBuilder::<()>::new();
route!(builder; r"/example/(\d+)"; "var1"; "GET" => ());
route!(builder; r"/test/(\d+)/(\d+)"; "var1", "var2"; "GET" => ());
let router = builder.build().unwrap();
Dispatching against a router:
match router.dispatch("GET", "/example/500") {
Some(route_match) => {
// Call handler and return response.
}
None => {
// No route match. Return 404.
}
};
An example hyper implementation can be found here: TBC
Issues & Support
Whether you're wanting to report a bug you've come across during use of this crate or are seeking general help/assistance, please utilise the issues tracker and provide as much detail as possible (eg. recreation steps).
I try to respond to issues within a reasonable timeframe.
40 Dec 18, 2022
16 Dec 18, 2022
7 Jun 12, 2022
7 Jul 1, 2023
5 Sep 6, 2023
8 Jan 3, 2024
3 May 4, 2023
722 Dec 27, 2022
34 Oct 22, 2022
1 Oct 27, 2021
502 Jan 8, 2023
101 Dec 19, 2022
3 Aug 2, 2022
2 Jul 30, 2022
32 Jan 17, 2023
8 Jun 24, 2023
9 Jul 28, 2023
1 Oct 27, 2021
246 Dec 27, 2022
5 May 2, 2022
294 Dec 23, 2022
4 Oct 4, 2022
1 Feb 11, 2022
2 Jan 10, 2022
42 Apr 16, 2023
3 Nov 1, 2023
25 Nov 2, 2020