Skip to main content

Crate eggfetch_http_connect

Crate eggfetch_http_connect 

Source
Expand description

Reusable HTTP/1 CONNECT wire mechanics over a caller-owned async stream.

This crate serializes CONNECT request bytes and parses CONNECT response heads. It does not dial sockets, perform TLS, retry, decide whether a status is acceptable, or own request deadlines.

  • The caller supplies an already-connected async byte stream.
  • ConnectTarget owns authority formatting (including IPv6 rules).
  • encode_connect_request serializes the request head.
  • read_connect_response_head parses the bounded response head while preserving read-ahead bytes for the tunnel.
  • Timeouts stay with the caller: wrap the encode/write future with a write deadline and the read future with a read deadline.
use eggfetch_http_connect::{
    ConnectRequest, ConnectResponseLimits, ConnectTarget,
    encode_connect_request, read_connect_response_head,
};
use tokio::io::BufReader;

let target = ConnectTarget::new("example.com", 443)?;
let request = ConnectRequest {
    target: &target,
    proxy_authorization: None,
    extra_headers: &[],
    max_head_bytes: 64 * 1024,
};
let bytes = encode_connect_request(&request)?;
assert!(bytes.starts_with(b"CONNECT example.com:443 HTTP/1.1\r\n"));

// In-memory stream: response head plus tunneled payload in one write.
let payload = b"HTTP/1.1 200 Connection Established\r\n\r\ntunneled-bytes";
let stream = tokio::io::duplex(1024);
let (mut client, mut server) = stream;
{
    use tokio::io::AsyncWriteExt;
    server.write_all(payload).await?;
    drop(server);
}
let mut reader = BufReader::new(client);
let head =
    read_connect_response_head(&mut reader, &ConnectResponseLimits::default()).await?;
assert_eq!(head.status, 200);
// Read-ahead remains readable through the same buffered stream.
{
    use tokio::io::AsyncReadExt;
    let mut rest = Vec::new();
    reader.read_to_end(&mut rest).await?;
    assert_eq!(rest, b"tunneled-bytes");
}

Structs§

ConnectRequest
A CONNECT request to serialize.
ConnectResponseHead
Parsed CONNECT response head.
ConnectResponseLimits
Caller-provided bounds for a CONNECT response head.
ConnectTarget
CONNECT destination in authority form.

Enums§

ConnectError
Neutral CONNECT wire error.

Functions§

basic_auth_value
Build a Basic <base64(user:pass)> proxy-auth value.
encode_connect_request
Serialize a CONNECT request head.
read_connect_response_head
Read one CONNECT response head from a buffered stream.