Struct ProviderRegistry 

pub struct ProviderRegistry { /* private fields */ }

A set of ProviderRules with domain lookup.

builtin seeds the well-known providers; applications can extend it with add. User-added rules take precedence over built-ins, so a custom rule can redefine a built-in provider.

Implementations

impl ProviderRegistry

pub fn empty() -> Self

An empty registry.

pub fn builtin() -> Self

The built-in registry of well-known mail providers.

Only Gmail/Googlemail ignore dots; every entry folds local-part case and uses + as its subaddress separator. All built-ins are freemail.

Returns an owned clone of a process-wide shared registry, so the rule set is constructed (and its domains IDNA-canonicalized) only once.

pub fn add(&mut self, rule: ProviderRule)

Add a rule. User-added rules take precedence over earlier ones.

pub fn with(self, rule: ProviderRule) -> Self

Builder-style add.

pub fn lookup(&self, domain: &str) -> Option<&ProviderRule>

Look up the rule for a domain, or None if no provider matches.

Most-recently-added rules win, so a custom rule overrides a built-in for the same domain. The domain is canonicalized to IDNA-ASCII once, so Unicode and punycode spellings resolve to the same rule.

Trait Implementations

impl Clone for ProviderRegistry

fn clone(&self) -> ProviderRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderRegistry

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

Formats the value using the given formatter.

impl Default for ProviderRegistry

fn default() -> Self

Returns the “default value” for a type.