Axum Named Routes

axum-named-routes is a library which allows users to easily define routes with names in axum, and get the route path from the route name at runtime.

Features

• Uses 100% safe rust with #![forbid(unsafe_code)]

• Simple wrapper over the axum router so correctness is left mostly to axum.

Usage Example

```rust use std::{net::SocketAddr, path::PathBuf}; use axum::routing::get; use axumnamedroutes::{NamedRouter, Routes};

async fn index() -> &'static str { "Hello, World!" }

// gets the routes from axum extensions async fn nestedother(routes: Routes) { // this could panic if the name is not in the Routes map // but we know that it is because we got here let thisroute = routes.has("ui.other"); asserteq!(thisroute, &PathBuf::from("/ui/other")); }

async fn other(routes: Routes) { // the get function does not panic rather it returns an Option let route = routes.get("ui.other"); let thisroute = routes.get("other"); assertne!(route, this_route); }

[tokio::main]

async fn main() { let ui = NamedRouter::new() .route("index", "/", get(index)) .route("other", "/other", get(nested_other)); let app = NamedRouter::new() .nest("ui", "/ui/", ui) .route("other", "/other", get(other));

let addr = SocketAddr::from(([127, 0, 0, 1], 3000));
axum::Server::bind(&addr)
    .serve(app.into_make_service())
    .await
    .unwrap();

} ```

That example can be found in examples/simple.rs.

Performance

The creation of the router adds slightly more overhead, but by sending the route map to an axum extension there should be no affects on request performance. Also the route map itself is based on an Arc meaning it should be performant when copied via the extension.

License

This project is licensed under the MIT license