Skip to content

Check if an email address exists without sending any email, written in Rust. Comes with a ⚙️ HTTP backend.

1.8 KB
Raw Blame
pub fn normalize_email(username: &str, domain: &str) -> String {
	match domain {
		"gmail.com" | "googlemail.com" => normalize_gmail(username),
		_ => format!("{username}@{domain}"),
	}
}

/// Normalize a Gmail address.
///
/// See Gmail username
/// [restrictions](https://support.google.com/mail/answer/9211434?hl=en-GB).
///
/// - removes
///   [sub-addresses](https://support.google.com/a/users/answer/9282734?hl=en#zippy=%2Clearn-how)
///   (i.e. parts after a `+` character.)
/// - removes [dots](https://support.google.com/mail/answer/7436150).
/// - converts to lower-case.
/// - [replaces](https://support.google.com/mail/answer/10313?hl=en-GB#zippy=%2Cgetting-messages-sent-to-an-googlemailcom-address)
///   `googlemail.com` with `gmail.com`.
fn normalize_gmail(username: &str) -> String {
	let username = match username.split_once('+') {
		Some((username, _)) => username,
		_ => username,
	}
	.chars()
	.filter_map(|c| match c.to_ascii_lowercase() {
		'.' => None,
		lower => Some(lower),
	})
	.collect::<String>();

	format!("{username}@gmail.com",)
}

#[cfg(test)]
mod tests {
	use super::*;

	#[test]
	fn test_gmail_removes_periods() {
		assert_eq!(normalize_email("a.b.c", "gmail.com"), "[email protected]");
	}

	#[test]
	fn test_gmail_removes_subaddress() {
		assert_eq!(normalize_email("abc+123", "gmail.com"), "[email protected]");
	}

	#[test]
	fn test_gmail_uses_gmail_com() {
		assert_eq!(normalize_email("abc", "googlemail.com"), "[email protected]");
	}

	#[test]
	fn test_gmail() {
		assert_eq!(
			normalize_email("A.B.C+123", "googlemail.com"),
			"[email protected]"
		);
	}

	#[test]
	fn test_gmail_idempotent() {
		let normalized = normalize_email("A.B.C+123", "googlemail.com");

		let (username, domain) = normalized.rsplit_once('@').unwrap();

		assert_eq!(normalize_email(username, domain), normalized);
	}
}