http_req

Simple and lightweight HTTP client with built-in HTTPS support.

HTTP and HTTPS via rust-native-tls (or optionally rustls)
Small binary size (0.7 MB for a basic GET request in the default configuratio)
Minimal number of dependencies

Requirements

http_req by default uses rust-native-tls, which relies on TLS framework provided by OS on Windows and macOS, and OpenSSL on all other platforms. But it also supports rustls.

All functionalities

Support for both HTTP and HTTPS protocols via rust-native-tls (or optionally rustls)
Creating and sending HTTP requests using the Request type (with extended capabilities provided via RequestMessage and Stream)
Representing HTTP responses with the Response type, allowing easy access to details like the status code and headers
Handling redirects using the RedirectPolicy
Support for Basic and Bearer authentication
Processing responses with Transfer-Encoding: chunked
Managing absolute Uris and partial support for relative Uris
Enforcing timeouts on requests
Downloading data in a streaming fashion, allowing direct saving to disk (minimizing RAM usage)
Error handling system allowing for better debugging
Utility functions for easily sending common request types: get, head, post

Usage

Default configuration

In order to use http_req with default configuration, add the following lines to Cargo.toml:

[dependencies]
http_req = "^0.14"

Rustls

In order to use http_req with rustls in your project, add the following lines to Cargo.toml:

[dependencies]
http_req = { version="^0.14", default-features = false, features = ["rust-tls"] }

HTTP only

In order to use http_req without any additional features in your project (no HTTPS, no Authentication), add the following lines to Cargo.toml:

[dependencies]
http_req = { version="^0.14", default-features = false }

Example

Basic HTTP GET request

use http_req::request;

fn main() {
    let mut body = Vec::new(); //Container for body of a response.
    let res = request::get("https://doc.rust-lang.org/", &mut body).unwrap();

    println!("Status: {} {}", res.status_code(), res.reason());
}

Take a look at more examples

License

Licensed under MIT.

http_req 0.14.2