deboa-tokio

Description

deboa-tokio ("fine" portuguese slang) is a deboa implementation for tokio runtime.

Attention

This release has a major api change. Please check the migration guide for more information.

Features

• easily add, remove and update headers
• helpers to add basic and bearer auth
• set retries and timeout
• pluggable catchers (interceptors)
• pluggable compression (gzip, deflate, br)
• pluggable serialization (json, xml, msgpack)
• cookies support
• urlencoded and multipart forms
• comprehensive error handling
• response streaming
• upgrade support (websocket, etc.)
• runtime compatibility (tokio and smol)
• http1/2/3 support

Benchmark Results

As of the latest benchmark run, Deboa demonstrates competitive performance compared to Reqwest.

Get Request

Install

Either run from command line:

cargo add deboa-tokio http

Or add to your Cargo.toml:

deboa-tokio = { version = "0.0.9", features = ["http1"] }
http = "1.3.1"

Crate features

• http1
• http2 (default)
• http3
• rust-tls (default)
• native-tls

Usage

use deboa::{
    request::{DeboaRequest, FetchWith, get},
    Result,
};
use deboa_tokio::Client;
use deboa_extras::serde::json::JsonBody;

use ::http::Method;

#[derive(Debug, serde::Deserialize)]
pub struct Post {
    pub id: u64,
    pub title: String,
    pub body: String,
}

#[tokio::main]
async fn main() -> Result<()> {
    let client = Client::default();

    /*
    // You can also use the Fetch trait to issue requests

    let posts: Vec<Post> = "https://jsonplaceholder.typicode.com/posts"
      .fetch_with(client)
      .await?
      .body_as(JsonBody)
      .await?;

    // or use at, from (defaults to GET) and to (defaults to POST) methods:

    let posts: Vec<Post> = DeboaRequest::at("https://jsonplaceholder.typicode.com/posts", Method::GET)?
      .send_with(client)
      .await?
      .body_as(JsonBody)
      .await?;

    // shifleft? Yes sir! Defaults to GET, but you can change it, same for headers.

    let request = &client << "https://jsonplaceholder.typicode.com/posts";
    let posts: Vec<Post> = client.execute(request)
      .await?
      .body_as(JsonBody)
      .await?;

    // or simply:

    let posts: Vec<Post> = client
      .execute("https://jsonplaceholder.typicode.com/posts")
      .await?
      .body_as(JsonBody)
      .await?;

    // you can also post a json body

    let body = serde_json::json!({
      "id": 100,
      "title": "Some title",
      "body": "Some body"
    });

    let request = post("https://jsonplaceholder.typicode.com/posts")?
      .header(header::CONTENT_TYPE, "application/json")
      .body_as(JsonBody, body)?;
    let response = request.send_with(&mut client).await?;
    assert_eq!(response.status(), 201);

    let posts: Vec<Post> = get("https://jsonplaceholder.typicode.com/posts")?
      .send_with(&client)
      .await?
      .body_as(JsonBody)
      .await?;

    println!("posts: {:#?}", posts);
    */

    Ok(())
}

Create project from template

You can create a new project from the template using cargo generate:

cargo generate ararog/deboa-templates

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Author

Rogerio Pereira Araujo rogerio.araujo@gmail.com