7 releases

0.3.0 Oct 20, 2021
0.1.5 May 20, 2019

#1 in #toql

38 downloads per month


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:

toql_rocket = "0.3"

Then enjoy some simplifications in your rocket handlers:

use toql_rocket::prelude::{ToqlQUery, Counted};
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.


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


~1M SLoC