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
110
111
112
113
114
115
116
117
118
119
120

use super::*;
use crate::h2::H2Error;
use crate::h2::frame::{Frame, FrameHeader, SettingsFrame};
use bytes::BytesMut;
use tokio::io::{AsyncReadExt, AsyncWriteExt};

#[tokio::test]
async fn write_and_read_settings() {
    let (client, server) = tokio::io::duplex(4096);

    let frame = SettingsFrame {
        ack: false,
        params: vec![(0x1, 65536), (0x2, 0), (0x4, 6291456)],
    };

    let mut writer = FrameWriter::new(client);
    writer.write_settings(&frame).await.unwrap();
    drop(writer);

    let mut reader = FrameReader::new(server);
    let read_frame = reader.next().await.unwrap().unwrap();

    match read_frame {
        Frame::Settings(s) => {
            assert!(!s.ack);
            assert_eq!(s.params, vec![(0x1, 65536), (0x2, 0), (0x4, 6291456)]);
        }
        _ => panic!("expected Settings frame"),
    }

    assert!(reader.next().await.unwrap().is_none());
}

#[tokio::test]
async fn write_and_read_preface_then_settings() {
    let (client, server) = tokio::io::duplex(4096);

    let mut writer = FrameWriter::new(client);
    writer.write_preface().await.unwrap();
    writer
        .write_settings(&SettingsFrame {
            ack: false,
            params: vec![(0x4, 6291456)],
        })
        .await
        .unwrap();
    drop(writer);

    let mut reader_raw = server;
    let mut preface = [0u8; 24];
    reader_raw.read_exact(&mut preface).await.unwrap();
    assert_eq!(&preface, b"PRI * HTTP/2.0\r\n\r\nSM\r\n\r\n");

    let mut reader = FrameReader::new(reader_raw);
    let frame = reader.next().await.unwrap().unwrap();
    assert!(matches!(frame, Frame::Settings(_)));
}

#[tokio::test]
async fn next_resumes_after_cancellation() {
    let (client, mut server) = tokio::io::duplex(1024);

    let frame = SettingsFrame {
        ack: false,
        params: vec![(0x1, 65536), (0x4, 6291456)],
    };
    let mut encoded = BytesMut::new();
    frame.encode(&mut encoded);
    let encoded = encoded.freeze();

    let server_task = tokio::spawn(async move {
        for byte in encoded.iter() {
            server.write_all(&[*byte]).await.unwrap();
            tokio::task::yield_now().await;
        }
        drop(server);
    });

    let mut reader = FrameReader::new(client);
    let read_frame = loop {
        tokio::select! {
            biased;
            res = reader.next() => {
                break res.unwrap().unwrap();
            }
            _ = tokio::task::yield_now() => {
                continue;
            }
        }
    };

    server_task.await.unwrap();
    match read_frame {
        Frame::Settings(s) => {
            assert_eq!(s.params, vec![(0x1, 65536), (0x4, 6291456)]);
        }
        _ => panic!("expected Settings frame"),
    }
}

#[tokio::test]
async fn rejects_oversized_frame() {
    let (client, server) = tokio::io::duplex(4096);

    let mut writer = client;
    let header = FrameHeader {
        length: 32768,
        frame_type: 0x0,
        flags: 0,
        stream_id: 1,
    };
    let mut buf = BytesMut::with_capacity(9);
    header.encode(&mut buf);
    writer.write_all(&buf).await.unwrap();
    drop(writer);

    let mut reader = FrameReader::new(server);
    let result = reader.next().await;
    assert!(matches!(result, Err(H2Error::FrameTooLarge { .. })));
}