cHTTP

The practical HTTP client that is fun to use.

Documentation

cHTTP provides a clean and easy-to-use interface around the venerable [libcurl]. Here are some of the features that are currently available:

• HTTP/2 support (if libcurl is compiled with it).
• Connection pooling and reuse.
• Respone body streaming.
• Request body uploading from memory or a stream.
• Tweakable redirect policy.
• TCP socket configuration.
• Uses the future standard Rust [http] interface for requests and responses.

Why [libcurl]?

Not everything needs to be re-invented! For typical use cases, [libcurl] is a fantastic choice for making web requests. It's fast, reliable, well supported, and isn't going away any time soon.

It has a reputation for having an unusual API that is sometimes tricky to use, but hey, that's why this library exists.

Examples

Really simple example that spits out the response body from https://example.org:

rust let mut response = chttp::get("https://example.org").unwrap(); let body = response.body_mut().text().unwrap(); println!("{}", body);

Configuring a custom client:

```rust use chttp::{http, Client, Options, RedirectPolicy}; use std::time::Duration;

let mut options = Options::default(); options.timeout = Some(Duration::fromsecs(60)); options.redirectpolicy = RedirectPolicy::Limit(10); options.preferredhttpversion = Some(http::Version::HTTP_2);

let client = Client::builder() .max_connections(Some(4)) .options(options) .build();

let mut response = client.get("https://example.org").unwrap(); let body = response.body_mut().text().unwrap(); println!("{}", body); ```

Requirements

On Linux:

• libcurl 7.24.0 or newer
• OpenSSL 1.0.1, 1.0.2, 1.1.0, or LibreSSL

On Windows and macOS:

• TBD

Installation

Add this to your Cargo.toml file:

toml [dependencies] chttp = "0.1"

License

This library is licensed under the MIT license. See the LICENSE file for details.