pata 0.0.1

A fast, lightweight, and evidence-driven email validation library for Rust
Documentation
//! Small, immutable signals derived from an address.

use crate::{Address, Classification};

#[cfg(feature = "classification")]
mod domains;
#[cfg(feature = "classification")]
mod providers;
#[cfg(feature = "classification")]
mod roles;

#[cfg(feature = "classification")]
pub(crate) const REVISION: Option<&str> = Some("2026-08-13.1");
#[cfg(not(feature = "classification"))]
pub(crate) const REVISION: Option<&str> = None;

pub(crate) fn classify(address: &Address) -> Classification {
    #[cfg(feature = "classification")]
    {
        let local = address.local().to_ascii_lowercase();
        let domain = address.domain().ascii();
        Classification::new(
            domains::is_disposable(domain),
            roles::contains(&local),
            domains::is_free(domain),
            providers::suggest(domain),
        )
    }
    #[cfg(not(feature = "classification"))]
    {
        let _ = address;
        Classification::default()
    }
}

#[cfg(all(test, feature = "classification"))]
mod tests {
    use super::*;

    #[test]
    fn snapshots_have_reviewed_cardinality() {
        assert_eq!(domains::disposable_count(), 8_201);
        assert_eq!(domains::free_count(), 1_561);
        assert_eq!(providers::COUNT, 28);
        assert_eq!(roles::COUNT, 26);
    }

    #[test]
    fn report_revision_matches_the_snapshot_manifest() {
        let manifest: toml::Value = toml::from_str(include_str!(
            "../examples/classifier_snapshot/snapshots.toml"
        ))
        .unwrap();

        assert_eq!(manifest["revision"].as_str(), REVISION);
    }

    #[test]
    fn disposable_services_include_their_subdomains() {
        assert!(domains::is_disposable("mailinator.com"));
        assert!(domains::is_disposable("inbound.mailinator.com"));
        assert!(!domains::is_disposable("mailinator.com.example"));
    }

    #[test]
    fn provider_suggestions_are_conservative() {
        assert_eq!(providers::suggest("gamil.com"), Some("gmail.com"));
        assert_eq!(providers::suggest("gmail.cmo"), Some("gmail.com"));
        assert_eq!(providers::suggest("gmail.co"), None);
        assert_eq!(providers::suggest("email.com"), None);
        assert_eq!(providers::suggest("gmail.com"), None);
        assert_eq!(providers::suggest("example.com"), None);
    }
}