hpx-util 2.0.0

Common utilities for hpx
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# hpx-util

[![crates.io](https://img.shields.io/crates/v/hpx-util.svg)](https://crates.io/crates/hpx-util)
[![docs.rs](https://docs.rs/hpx-util/badge.svg)](https://docs.rs/hpx-util)
[![License](https://img.shields.io/crates/l/hpx-util.svg)](https://github.com/longcipher/hpx)

Common utilities for the [hpx](https://github.com/longcipher/hpx) HTTP client.

## Features

- **Browser Emulation**: TLS fingerprinting and HTTP/2 settings emulation for Chrome, Firefox, Safari, Opera, and OkHttp
- **Tower Middleware**: Delay and jitter layers for Tower services

## Quick Start

```rust
use hpx_util::Emulation;

#[tokio::main]
async fn main() -> hpx::Result<()> {
    let resp = hpx::get("https://tls.peet.ws/api/all")
        .emulation(Emulation::Firefox136)
        .send()
        .await?;

    println!("{}", resp.text().await?);
    Ok(())
}
```

## Feature Flags

| Feature | Default | Description |
|---------|---------|-------------|
| `emulation` | **Yes** | Browser emulation profiles (Chrome, Firefox, Safari, Opera, OkHttp) |
| `emulation-compression` | No | Compression settings for emulation profiles |
| `emulation-rand` | No | Random emulation profile selection |
| `emulation-serde` | No | Serde serialization for emulation types |
| `tower-delay` | No | Delay/jitter Tower middleware layer |

## Emulation Profiles

The `emulation` feature provides pre-configured browser fingerprint profiles:

- **Chrome**: Multiple versions with accurate TLS/HTTP2 settings
- **Firefox**: Firefox browser emulation
- **Safari**: Safari browser emulation
- **Opera**: Opera browser emulation
- **OkHttp**: OkHttp client emulation

## Tower Middleware

The `tower-delay` feature provides:

- `DelayLayer` — Fixed delay middleware
- `DelayLayerWith` — Configurable delay with jitter

## License

Apache-2.0