Deboa

Description

deboa ("fine" portuguese slang) is a straightforward, non opinionated, developer-centric HTTP client library for Rust. It offers a rich array of modern features—from flexible authentication and serialization formats to runtime compatibility and middleware support—while maintaining simplicity and ease of use. It’s especially well-suited for Rust projects that require a lightweight, efficient HTTP client without sacrificing control or extensibility.

Built using hyper.

Attention

This release has a major api change. Please check the migration guide for more information. Keep in mind API is subject to change for next 2 or 3 stable releases.

Install

deboa = { version = "0.1.3" }

Runtimes

• compio
• glommio
• smol
• tokio

Usage

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

#[tokio::main]
async fn main() -> Result<()> {
  // Create a new Client instance, set timeouts, catches and protocol.
  let client = Client::new();

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

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

  Ok(())
}

Subcrates

deboa

Top level project with runtime agnostic http client API.

deboa-macros

A crate with collection of convenience macros for deboa. It is close equivalent to apisauce for axios, where one macro does it all, from request to response. It used to be the home of bora macro, which has been moved to vamo-macros crate.

deboa-compio (moved)

Deboa implementation for compio runtime to https://github.com/deboa-client/deboa-compio.

deboa-extras

• SSE, rate limiting and several serialization and deserialization formats support.

deboa-fory

• Apache Fory serialization and deserialization support.

deboa-h3

• HTTP3 utilities for deboa

deboa-hickory

Deboa extension crate providing DNS resolution via hickory-resolver.

deboa-glommio (moved)

Deboa implementation for glommio runtime to https://github.com/deboa-client/deboa-glommio.

deboa-smol (moved)

Deboa implementation for smol runtime to https://github.com/deboa-client/deboa/deboa-smol.

deboa-tokio (moved)

Deboa implmentation for tokio runtime to https://github.com/deboa-client/deboa/deboa-tokio.

deboa-ws

Websockets support to deboa-tokio and deboa-smol

vamo (moved)

Vamo has moved to https://github.com/deboa-client/vamo.

vamo-macros (moved)

Vamo-macros has moved to https://github.com/deboa-client/vamo.

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