Crate awc

awc is an asynchronous HTTP and WebSocket client library.

GET Requests

// create client
let mut client = awc::Client::default();

// construct request
let req = client.get("http://www.rust-lang.org")
    .insert_header(("User-Agent", "awc/3.0"));

// send request and await response
let res = req.send().await?;
println!("Response: {:?}", res);

POST Requests

Raw Body

let mut client = awc::Client::default();
let response = client.post("http://httpbin.org/post")
    .send_body("Raw body contents")
    .await?;

JSON

let request = serde_json::json!({
    "lang": "rust",
    "body": "json"
});

let mut client = awc::Client::default();
let response = client.post("http://httpbin.org/post")
    .send_json(&request)
    .await?;

URL Encoded Form

let params = [("foo", "bar"), ("baz", "quux")];

let mut client = awc::Client::default();
let response = client.post("http://httpbin.org/post")
    .send_form(&params)
    .await?;

Response Compression

All official and common content encoding codecs are supported, optionally.

The Accept-Encoding header will automatically be populated with enabled codecs and added to outgoing requests, allowing servers to select their Content-Encoding accordingly.

Feature flags enable these codecs according to the table below. By default, all compress-* features are enabled.

Feature	Codecs
compress-brotli	brotli
compress-gzip	gzip, deflate
compress-zstd	zstd

WebSockets

use futures_util::{SinkExt as _, StreamExt as _};

let (_resp, mut connection) = awc::Client::new()
    .ws("ws://echo.websocket.org")
    .connect()
    .await?;

connection
    .send(awc::ws::Message::Text("Echo".into()))
    .await?;

let response = connection.next().await.unwrap()?;
assert_eq!(response, awc::ws::Frame::Text("Echo".into()));

Re-exports

pub use cookie;cookies

Modules

body

Traits and structures to aid consuming and writing HTTP payloads.

error

HTTP client errors

http

Various HTTP related types.

middleware

test

Test helpers for actix http client to use during testing.

ws

Websockets client

Structs

Client

An asynchronous HTTP and WebSocket client.

ClientBuilder

An HTTP Client builder

ClientRequest

An HTTP Client request builder

ClientResponse

Client Response

Connect

Connector

Manages HTTP client network connectivity.

FrozenClientRequest

FrozenClientRequest struct represents cloneable client request.

FrozenSendBuilder

Builder that allows to modify extra headers.

JsonBody

A Future that reads a body stream, parses JSON, resolving to a deserialized T.

ResponseBody

A Future that reads a body stream, resolving as Bytes.

Enums

ConnectRequest

Combined HTTP and WebSocket request type received by connection service.

ConnectResponse

Combined HTTP response & WebSocket tunnel type returned from connection service.

SendClientRequest

Future that sends request’s payload and resolves to a server response.

Type Aliases

BoxConnectorService

BoxedSocket

MessageBodyDeprecated