/reqwestplus

A fork of reqwest (An easy and powerful Rust HTTP Client) with additional features.

Primary LanguageRustApache License 2.0Apache-2.0

reqwestplus

A fork of reqwest and reqwest-impersonate containing additional features like TLS and h2 configurations.

This fork has features designed to match my specific usecase, and although open source, it isn't intended for general use. I can't guarantee API stability, or that any of additional features will make sense to you.

Features added

  • Impersonate Chrome's TLS and HTTP/2 fingerprint
  • Change proxy on an initialized client
  • Custom header order with custom implementation of http's HeaderMap that preserves the insert order, and header_order option in ClientBuilder
  • Ability to disable default accept header with accept_header option in ClientBuilder

It is currently missing HTTP/2 PRIORITY support. (PRs to h2 are welcome)

Notice: This crate depends on patched dependencies. To use it, please add the following to your Cargo.toml.

[patch.crates-io]
hyper = { git = "https://github.com/4JX/hyper.git", branch = "v0.14.18-patched" }
h2 = { git = "https://github.com/4JX/h2.git", branch = "imp" }
http = { git = "https://github.com/ignassew/http-ordered" }

These patches were made specifically for reqwestplus to work, but I would appreciate if someone took the time to PR more "proper" versions to the parent projects.

Example

Cargo.toml

reqwestplus = { git = "https://github.com/ignassew/reqwestplus", default-features = false, features = [
    "chrome",
    "blocking",
] }

main.rs

use reqwestplus::browser::ChromeVersion;

fn main() {
    // Build a client to mimic Chrome 104
    let client = reqwestplus::blocking::Client::builder()
        .chrome_builder(ChromeVersion::V104)
        .build()
        .unwrap();

    // Use the API you're already familiar with
    match client.get("https://yoururl.com").send() {
        Ok(res) => {
            println!("{:?}", res.text().unwrap());
        }
        Err(err) => {
            dbg!(err);
        }
    };
}

Original readme

crates.io Documentation MIT/Apache-2 licensed CI

An ergonomic, batteries-included HTTP Client for Rust.

  • Plain bodies, JSON, urlencoded, multipart
  • Customizable redirect policy
  • HTTP Proxies
  • HTTPS via system-native TLS (or optionally, rustls)
  • Cookie Store
  • WASM
  • Changelog

Example

This asynchronous example uses Tokio and enables some optional features, so your Cargo.toml could look like this:

[dependencies]
reqwest = { version = "0.11", features = ["json"] }
tokio = { version = "1", features = ["full"] }

And then the code:

use std::collections::HashMap;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let resp = reqwest::get("https://httpbin.org/ip")
        .await?
        .json::<HashMap<String, String>>()
        .await?;
    println!("{:#?}", resp);
    Ok(())
}

Blocking Client

There is an optional "blocking" client API that can be enabled:

[dependencies]
reqwest = { version = "0.11", features = ["blocking", "json"] }
use std::collections::HashMap;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let resp = reqwest::blocking::get("https://httpbin.org/ip")?
        .json::<HashMap<String, String>>()?;
    println!("{:#?}", resp);
    Ok(())
}

Requirements

On Linux:

On Windows and macOS:

  • Nothing.

Reqwest uses rust-native-tls, which will use the operating system TLS framework if available, meaning Windows and macOS. On Linux, it will use OpenSSL 1.1.

License

Licensed under either of

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.