Struct Timeouts 

pub struct Timeouts {
    pub total: Duration,
    pub connect: Duration,
    pub tls_handshake: Duration,
    pub request: Duration,
    pub response_headers: Duration,
    pub idle: Duration,
    pub read: Duration,
    pub write: Duration,
}

Granular timeout configuration for HTTP requests.

Each timeout controls a specific phase of the request lifecycle. All timeouts default to sensible values optimized for Tor’s latency.

Fields

total: Duration

Total request timeout (default: 30s)

The maximum time allowed for the entire request, from initiating the connection to receiving the complete response.

connect: Duration

Connection timeout (default: 10s)

Maximum time to establish a TCP connection through Tor. This includes circuit building if needed.

tls_handshake: Duration

TLS handshake timeout (default: 10s)

Maximum time for the TLS handshake after TCP connection.

request: Duration

Request send timeout (default: 30s)

Maximum time to send the complete request (headers + body).

response_headers: Duration

Response header timeout (default: 30s)

Maximum time to receive the response headers after sending the request.

idle: Duration

Idle timeout for pooled connections (default: 90s)

Maximum time a connection can remain idle in the pool before being closed.

read: Duration

Read timeout per chunk (default: 30s)

Maximum time to wait for data while reading the response body.

write: Duration

Write timeout per chunk (default: 30s)

Maximum time to wait while writing request data.

Implementations

impl Timeouts

pub fn new() -> Self

Create a new timeout configuration with defaults.

pub fn fast() -> Self

Create timeouts optimized for fast responses (short timeouts).

pub fn slow() -> Self

Create timeouts for slow/large transfers.

pub fn none() -> Self

Create timeouts with no limits (use with caution).

pub fn with_total(self, timeout: Duration) -> Self

Set the total request timeout.

pub fn with_connect(self, timeout: Duration) -> Self

Set the connection timeout.

pub fn with_tls_handshake(self, timeout: Duration) -> Self

Set the TLS handshake timeout.

pub fn with_idle(self, timeout: Duration) -> Self

Set the idle timeout.

pub fn with_read(self, timeout: Duration) -> Self

Set the read timeout.

pub fn with_write(self, timeout: Duration) -> Self

Set the write timeout.

pub fn has_zero(&self) -> bool

Check if any timeout is zero (invalid).

pub fn effective_connect(&self) -> Duration

Get the minimum of total timeout and a specific phase timeout.

pub fn effective_tls(&self) -> Duration

Get the effective TLS handshake timeout.

pub fn effective_read(&self) -> Duration

Get the effective read timeout.

Trait Implementations

impl Clone for Timeouts

fn clone(&self) -> Timeouts

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Timeouts

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Timeouts

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Timeouts