A generic async HTTP request create.
It is meant to be a thin wrapper around various HTTP clients and handles TLS, serialisation and parsing.
The main goal is to allow binaries (that pull in some libraries that make use of a HTTP client) to specify what implementation should be used.
And if there is a Proxy. If not specified auto detection is performed by looking at HTTP_PROXY.
You need to specify via features what crates are used to the actual work.
|feature flag|Meaning| |---|---| |usehyper|Use hyper for HTTP| |useasynch1|Use asynch1 for HTTP| |rustls|Add support for HTTPS via rustls| |proxies|Add support for Socks5 and HTTP proxy| |hypernativetls|Use hyper for HTTP and do HTTPS via nativetls| |asyncnativetls|Use asynch1 for HTTP and do HTTPS via native_tls|
Without anything specified you will end up with No HTTP backend was selected. If you use this crate for a library, please reexport the apropriate features.
Rust offers different async runtimes that - on a high level - offer the same thing: asyncrounes functions for files, sockets and so on.
So if you write a lib and need some basic stiff (like an http client) you sometimes have to make choices that are not what your crates users would have liked. For example: I wrote a webserver based on hyper and wanted to add ACME. A crate I found did what I needed but used async-h1 and async-std. While that worked, it did increase the binary size and crates I depend on by a good amount.
So I wrote this. You can specify which backend to use.
In the Webserver case, using tokio which is already a dependency VS async-std did lead to 81 less crates and a 350kB smaller binary.
Using (and async-acme):
[profile.release]
lto = "fat"
codegen-units = 1
Also for http clients: there should be a way to add a proxy for all libs that use it.