#url-path #path-query #routes #structs #deserialize #query-string #applications

macro app_route_derive

A procedural macro to allow automatic deserialization of URL path + query parameters into Rust structs

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

MIT license

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