deboa

Description

deboa 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.

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 base url only once, change it when needed
request data only by specifying path
set retries and timeout
pluggable middleware
pluggable compression (gzip, deflate, br)
pluggable serialization (json, xml, msgpack)
bora macro to easily create api clients
cookies support
comprehensive error handling
runtime compatibility (tokio and smol)
http1/2 support

Install

deboa = { version = "0.0.5-alpha.2", features = ["http1", "tokio-rt"] }

Crate features

tokio-rt (default)
smol-rt
http1 (default)
http2

Usage

use deboa::{Deboa, request::DeboaRequest};
use deboa_extras::http::serde::json::JsonBody;

let mut client = Deboa::new();

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

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

License

MIT

Author

Rogerio Pereira Araujo rogerio.araujo@gmail.com

deboa 0.0.5-alpha.3