7 releases

0.3.0 Oct 20, 2021
0.1.5 May 20, 2019

#1 in #toql

37 downloads per month

MIT/Apache

11KB
156 lines

Toql Rocket

Use Toql with Rocket.

This crate adds:

  • Toql URL query parameters
  • Response headers with page count information
  • Responder for ToqlError

Add this to your Cargo.toml:

[dependencies]
toql_rocket = "0.3"

Then enjoy some simplifications in your rocket handlers:

use toql_rocket::prelude::{ToqlQUery, Counted};
#[get("/?<toql_query..>")]
pub async fn query(
    cache: &State<Cache>,
    mut conn: Connection<TodoDb>,
    toql_query: ToqlQuery,  //<!-- Get URL parameters with default values
) -> Result<Counted<Json<Vec<Todo>, MyError>>>  
{
    let mut toql = MySqlAsync::from(&mut *conn, &*cache);
    let (query, page) = toql_query.parse::<Todo>()?; //<!-- Parse into typesafe query
    let r = toql.load_page(query, page).await?;

    Ok(Counted(Json(r.0), r.1)) //<!-- Put page count information into headers
}

Check out the full featured REST server based on Rocket, Toql and MySQL.

License

Toql Rocket is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

Dependencies

~22–60MB
~1M SLoC