leyline-http 0.1.5

HTTP client that impersonates Chrome, Firefox, and Safari on the wire: TLS (JA3/JA4), HTTP/2, and HTTP/3 fingerprints
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

use super::*;

#[test]
fn chrome_brand_has_no_overlay() {
    let ua = "Mozilla/5.0 ...";
    assert!(
        ChromiumBrand::Chrome
            .overlay(147, Platform::Windows, ua)
            .unwrap()
            .is_none()
    );
}

#[test]
fn edge_overlay_populates_ua_and_headers() {
    let ua = "Mozilla/5.0 ... Chrome/147.0.0.0 Safari/537.36";
    let o = ChromiumBrand::Edge
        .overlay(147, Platform::Windows, ua)
        .unwrap()
        .unwrap();
    assert!(
        o.user_agent.ends_with(" Edg/147.0.0.0"),
        "Edge UA must end with reduced Edg/{{major}}.0.0.0: {}",
        o.user_agent
    );
    assert!(o.sec_ch_ua.contains(r#""Microsoft Edge";v="147""#));
}

#[test]
fn opera_overlay_matches_live_capture() {
    let ua = "Mozilla/5.0 ... Chrome/145.0.0.0 Safari/537.36";
    let o = ChromiumBrand::Opera
        .overlay(145, Platform::Windows, ua)
        .unwrap()
        .unwrap();
    assert!(o.user_agent.ends_with(" OPR/129.0.0.0"));
    assert_eq!(
        o.sec_ch_ua,
        r#""Not:A-Brand";v="99", "Opera";v="129", "Chromium";v="145""#
    );
}

#[test]
fn edge_overlay_on_desktop_ok_for_all_three_platforms() {
    for p in [Platform::Windows, Platform::MacOS, Platform::Linux] {
        ChromiumBrand::Edge
            .overlay(147, p, "ua")
            .expect("expected Ok");
    }
}

#[test]
fn edge_overlay_on_mobile_errors() {
    for p in [Platform::Android, Platform::IOS] {
        let err = ChromiumBrand::Edge.overlay(147, p, "ua").unwrap_err();
        assert!(matches!(err, BrandOverlayError::Unverified { .. }));
    }
}

#[test]
fn opera_overlay_only_accepts_verified_anchors() {
    let row = brand_row(ChromiumBrand::Opera).expect("Opera brand row");
    let mut anchors: Vec<u32> = row
        .versions
        .keys()
        .map(|k| k.parse().expect("Chromium major"))
        .collect();
    anchors.sort_unstable();
    for chromium in &anchors {
        let expected_opera =
            version_major(&row.versions[&chromium.to_string()][0]).expect("Opera major");
        let o = ChromiumBrand::Opera
            .overlay(*chromium, Platform::Windows, "ua")
            .unwrap()
            .unwrap();
        assert!(
            o.user_agent
                .ends_with(&format!(" OPR/{expected_opera}.0.0.0")),
            "Chromium {chromium} should map to OPR/{expected_opera}: {}",
            o.user_agent
        );
    }
    let (first, last) = (anchors[0], anchors[anchors.len() - 1]);
    for bad in [first - 1, last + 1] {
        ChromiumBrand::Opera
            .overlay(bad, Platform::Windows, "ua")
            .expect_err("expected Err");
    }
    for p in [Platform::Android, Platform::IOS] {
        ChromiumBrand::Opera
            .overlay(147, p, "ua")
            .expect_err("expected Err");
    }
}

#[test]
fn error_display_uses_platform_display_not_debug() {
    let err = BrandOverlayError::Unverified {
        brand: ChromiumBrand::Opera,
        chromium_major: 147,
        platform: Platform::MacOS,
    };
    let msg = format!("{err}");
    assert!(
        msg.contains("/ macOS /") || msg.contains("/ macOS"),
        "{msg}"
    );
    assert!(!msg.contains("MacOS"), "{msg}");
}