5 unstable releases
0.3.0 | Jun 16, 2019 |
---|---|
0.2.1 | May 8, 2019 |
0.2.0 | May 8, 2019 |
0.1.1 | May 7, 2019 |
0.1.0 | Apr 26, 2019 |
#12 in #path-query
Used in app_route
15KB
361 lines
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
[dependencies]
app_route = "0.1"
serde = { version = "1.0", features = ["derive"] }
main.rs
use app_route::AppRoute;
use serde::{Deserialize, Serialize};
#[derive(Debug, Serialize, Deserialize, PartialEq)]
struct UserListQuery {
limit: Option<u64>,
offset: Option<u64>,
keyword: Option<String>,
#[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&friends_only=false&keyword=some_keyword"
.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
- 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
Dependencies
~5MB
~98K SLoC