deboa-smol

Description

deboa-smol ("fine" portuguese slang) is a deboa implementation for smol 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
• compression (gzip, deflate, br)
• pluggable hooks
• pluggable serialization (json, xml, msgpack)
• cookies support
• urlencoded and multipart forms
• comprehensive error handling
• response streaming
• upgrade support (websocket, etc.)
• http 1/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-smol http

Or add to your Cargo.toml:

deboa = { version = "0.1.0-beta.23" }
deboa-smol = { version = "0.1.0-beta.12" }
http = "1.3.1"

Crate features

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

Usage

use deboa::{
    Client,
    request::{DeboaRequest, FetchWith, get},
    Result,
};
use deboa_smol::InnerClient;
use deboa_extras::serde::json::JsonBody;
use ::http::Method;
use macro_rules_attribute::apply;
use smol_macros::main;

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

#[apply(main!)]
async fn main() -> Result<()> {
    let client = Client::<InnerClient>::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