3 unstable releases
new 0.3.1 | May 2, 2024 |
---|---|
0.3.0 | Apr 30, 2024 |
0.2.1 | Apr 21, 2024 |
0.2.0 |
|
#201 in HTTP client
285 downloads per month
26KB
356 lines
tower-http-client
This library provides middlewares and various utilities for HTTP-clients.
Thus, it extends the tower_http
functionality for creating HTTP clients
using tower
middlewares.
At the moment, the de facto standard client library is reqwest
, which is
poorly compatible with the tower
services, but thanks to the
tower_reqwest
crate, it can be used with the any tower_http
layers.
The first goal of the project is to create a more flexible and extensible
alternative for reqwest_middleware
.
Warning
This crate is currently in early stage of development and is not ready for production use.
Example
use http::{header::USER_AGENT, HeaderValue};
use tower::{ServiceBuilder, ServiceExt};
use tower_http::ServiceBuilderExt;
use tower_http_client::{ServiceExt as _, ResponseExt as _};
use tower_reqwest::HttpClientLayer;
/// Implementation agnostic HTTP client.
type HttpClient = tower::util::BoxCloneService<
http::Request<reqwest::Body>,
http::Response<reqwest::Body>,
anyhow::Error,
>;
/// Creates HTTP client with Tower layers on top of the given client.
fn make_client(client: reqwest::Client) -> HttpClient {
ServiceBuilder::new()
// Add some layers.
.override_request_header(USER_AGENT, HeaderValue::from_static("tower-http-client"))
// Make client compatible with the `tower-http` layers.
.layer(HttpClientLayer)
.service(client)
.map_err(anyhow::Error::from)
.boxed_clone()
}
#[tokio::main]
async fn main() -> anyhow::Result<()> {
// Create a new client
let client = make_client(reqwest::Client::new());
// Execute request by using this service.
let response = client
.get("http://ip.jsontest.com")
.send()?
.await?;
let text = response.body_reader().utf8().await?;
println!("{text}");
Ok(())
}
Dependencies
~2–17MB
~179K SLoC