Struct HttpConfig 

pub struct HttpConfig {
    pub tls_verify: bool,
    pub tls_cacerts: Option<TlsCacerts>,
    pub user_agent: Option<String>,
    pub timeout: Option<f64>,
}

Sphinx’s shared HTTP configuration group plus intersphinx_timeout (ext/intersphinx/_load.py:211-227, _InvConfig).

Fields

tls_verify: bool

tls_cacerts: Option<TlsCacerts>

user_agent: Option<String>

timeout: Option<f64>

Seconds. None is Sphinx’s default and means no timeout — the value is handed to requests as timeout=None (ext/intersphinx/__init__.py:70-72).

Implementations

impl HttpConfig

pub fn user_agent(&self) -> &str

headers.setdefault('User-Agent', _user_agent or _USER_AGENT) (util/requests.py:96-97): an empty configured value is falsy in Python and so also falls back to the default.

pub fn timeout_duration(&self) -> Option<Duration>

timeout as a Duration, or None for “no timeout” — which is both Sphinx’s default and what an unusable value degrades to.

intersphinx_timeout arrives from conf.py as an unvalidated f64, and Duration::from_secs_f64 panics on a negative, NaN or overflowing one. intersphinx_timeout = -1 is a natural thing to write (intersphinx_cache_limit = -1 is the documented Sphinx idiom for “never expire”), and with panic = "abort" in the release profile that panic is a bare SIGABRT naming neither the config key nor the file. Sphinx wraps the whole fetch in except Exception (ext/intersphinx/_load.py:302-313), so a bad value there is one entry in failures and the build carries on; this degrades the same way, and says which value it rejected.

pub fn ca_bundle_for(&self, url: &str) -> Option<&str>

_get_tls_cacert(url, tls_cacerts) (util/requests.py:34-45): a plain string is the bundle for every URL; a mapping is keyed by the URL’s netloc with userinfo stripped, and a host it does not name falls back to the default trust store.

Trait Implementations

impl Clone for HttpConfig

fn clone(&self) -> HttpConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpConfig

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

Formats the value using the given formatter.

impl Default for HttpConfig

Hand-written rather than derived: bool::default() is false, and a default that silently turns off certificate verification is not a default anyone should be able to reach by accident. Sphinx’s tls_verify default is True (config.py:286), and so is this one.

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for HttpConfig

fn eq(&self, other: &HttpConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for HttpConfig