Enum CatalogueFingerprint 

pub enum CatalogueFingerprint {
    Requests,
    Urllib3,
    Httpx,
    Scrapy,
    Axios,
    NodeFetch,
    CurlLegacy,
}

Known catalogue fingerprints that HttpAdapter refuses to send by default.

Each variant is matched by CatalogueFingerprint::matches against the outbound User-Agent string. The deny-list is exhaustive: every CatalogueFingerprint variant must have a non-empty match pattern (compile-time enforced by Self::PATTERNS).

Adding a new variant here is a deliberate security decision: the caller is declaring “this UA is so widely catalogued that any request bearing it will be flagged by detector suites faster than a silent request would be.” The companion allow-list lives in CatalogueFingerprint::is_browser_class.

Variants

Requests

python-requests — the canonical Python HTTP library banner. Catalogued by every major detector suite within seconds.

Urllib3

python-urllib3 — the lower-level Python library.

Httpx

httpx — modern async Python HTTP client.

Scrapy

Scrapy/<version> — Python scraping framework default UA.

Axios

axios/<version> — Node.js fetch library default UA.

NodeFetch

node-fetch — older Node.js fetch polyfill default UA.

CurlLegacy

curl/<8.4 — older curl versions are widely catalogued. curl/8.4+ is not on the deny-list (curl ships a TLS fingerprint that looks like a real client, not a library).

Implementations

impl CatalogueFingerprint

pub fn matches(self, ua: &str) -> bool

Match the User-Agent string against this catalogue entry.

pub const fn label(self) -> &'static str

Static label suitable for metrics and log lines.

pub fn detect(ua: &str) -> Option<Self>

true if ua matches any catalogue variant. Use this to gate pre-send checks.

pub fn is_browser_class(ua: &str) -> bool

true if ua looks like a browser-class User-Agent — the allow-list companion to the catalogue deny-list. Substrings checked here are the browser tokens that the rotation pool relies on.

Trait Implementations

impl Clone for CatalogueFingerprint

fn clone(&self) -> CatalogueFingerprint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CatalogueFingerprint

impl Debug for CatalogueFingerprint

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CatalogueFingerprint

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CatalogueFingerprint

impl Hash for CatalogueFingerprint

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CatalogueFingerprint

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CatalogueFingerprint

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CatalogueFingerprint