AppRoute

Treat application routes (URL path + query string) as strongly-typed Rust structs

Dependencies

• cargo
• rustc

Build

$ cargo build

Test

$ cargo test

Benchmark

$ cargo bench

Example Code

src/Cargo.toml toml [dependencies] app_route = "0.1" serde = { version = "1.0", features = ["derive"] }

main.rs ```rust use app_route::AppRoute; use serde::{Deserialize, Serialize};

[derive(Debug, Serialize, Deserialize, PartialEq)]

struct UserListQuery { limit: Option, offset: Option, keyword: Option,

#[serde(default)]
friends_only: bool,

}

[derive(AppRoute, Debug, PartialEq)]

[route("/groups/:group_id/users")]

struct UsersListRoute { group_id: u64,

#[query]
query: UserListQuery,

}

fn main() { let path: UsersListRoute = "/groups/4313145/users?offset=10&limit=20&friendsonly=false&keyword=somekeyword" .parse() .unwrap();

assert_eq!(
    path,
    UsersListRoute {
        group_id: 4313145,
        query: {
            UserListQuery {
                limit: Some(20),
                offset: Some(10),
                keyword: Some("some_keyword".to_string()),
                friends_only: false,
            }
        }
    }
);

println!("Path: {}", path);
// Output:
// Path: /groups/4313145/users?limit=20&offset=10&keyword=some_keyword&friends_only=false

}

```

TODO

• [ ] URL Hash Fragments
• [x] Support trailing wildcard as a path param
• [ ] Make the AppRoute trait object-safe if possible
• [ ] Use spans properly in the procedural macro so errors actually make sense