use scraper::{Html, Selector};
use std::collections::HashSet;
use std::fmt;
use std::sync::LazyLock;
fn percent_decode(s: &str) -> String {
let mut result = Vec::with_capacity(s.len());
let bytes = s.as_bytes();
let mut i = 0;
while i < bytes.len() {
if bytes[i] == b'%' && i + 2 < bytes.len() {
if let (Some(hi), Some(lo)) = (hex_val(bytes[i + 1]), hex_val(bytes[i + 2])) {
result.push(hi << 4 | lo);
i += 3;
continue;
}
}
result.push(bytes[i]);
i += 1;
}
String::from_utf8_lossy(&result).to_string()
}
fn hex_val(b: u8) -> Option<u8> {
match b {
b'0'..=b'9' => Some(b - b'0'),
b'a'..=b'f' => Some(b - b'a' + 10),
b'A'..=b'F' => Some(b - b'A' + 10),
_ => None,
}
}
const ANCHOR_SELECTOR_STR: &str = "a[href]";
static ANCHOR_SELECTOR: LazyLock<Selector> = LazyLock::new(|| {
Selector::parse(ANCHOR_SELECTOR_STR)
.expect("ANCHOR_SELECTOR_STR is a hardcoded valid CSS selector; this is a compile-time bug")
});
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum ContactType {
Email,
Phone,
}
impl ContactType {
pub fn as_str(self) -> &'static str {
match self {
ContactType::Email => "email",
ContactType::Phone => "phone",
}
}
}
impl fmt::Display for ContactType {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
f.write_str(self.as_str())
}
}
#[derive(Debug, Clone)]
pub struct ContactLink {
pub contact_type: ContactType,
pub value: String,
pub raw_href: String,
}
pub fn extract_contact_links(document: &Html) -> Vec<ContactLink> {
let mut links = Vec::new();
let mut seen: HashSet<(ContactType, String)> = HashSet::new();
for element in document.select(&ANCHOR_SELECTOR) {
if let Some(href) = element.value().attr("href") {
let href_lower = href.to_lowercase();
if href_lower.starts_with("mailto:") {
let rest = &href["mailto:".len()..];
let raw_value = rest.split('?').next().unwrap_or(rest).trim();
let value = percent_decode(raw_value);
if value.is_empty() {
continue;
}
let key = (ContactType::Email, value.clone());
if seen.insert(key) {
links.push(ContactLink {
contact_type: ContactType::Email,
value,
raw_href: href.to_string(),
});
}
} else if href_lower.starts_with("tel:") {
let raw_value = href["tel:".len()..].trim();
let value = percent_decode(raw_value);
if value.is_empty() {
continue;
}
let key = (ContactType::Phone, value.clone());
if seen.insert(key) {
links.push(ContactLink {
contact_type: ContactType::Phone,
value,
raw_href: href.to_string(),
});
}
}
}
}
links
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_extract_mailto() {
let html = Html::parse_document(
r#"<html><body><a href="mailto:info@example.com">Contact us</a></body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 1);
assert_eq!(links[0].contact_type, ContactType::Email);
assert_eq!(links[0].value, "info@example.com");
assert_eq!(links[0].raw_href, "mailto:info@example.com");
}
#[test]
fn test_extract_tel() {
let html = Html::parse_document(
r#"<html><body><a href="tel:+1-800-555-1234">Call us</a></body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 1);
assert_eq!(links[0].contact_type, ContactType::Phone);
assert_eq!(links[0].value, "+1-800-555-1234");
}
#[test]
fn test_extract_mailto_with_query_params() {
let html = Html::parse_document(
r#"<html><body><a href="mailto:info@example.com?subject=Hello&body=Hi">Email</a></body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 1);
assert_eq!(links[0].value, "info@example.com");
}
#[test]
fn test_extract_multiple_contacts() {
let html = Html::parse_document(
r#"<html><body>
<a href="mailto:sales@example.com">Sales</a>
<a href="mailto:support@example.com">Support</a>
<a href="tel:+1-800-555-0001">Phone</a>
</body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 3);
}
#[test]
fn test_extract_deduplicates() {
let html = Html::parse_document(
r#"<html><body>
<a href="mailto:info@example.com">Contact 1</a>
<a href="mailto:info@example.com">Contact 2</a>
</body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 1);
}
#[test]
fn test_extract_empty_mailto() {
let html = Html::parse_document(r#"<html><body><a href="mailto:">Empty</a></body></html>"#);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 0);
}
#[test]
fn test_extract_empty_tel() {
let html = Html::parse_document(r#"<html><body><a href="tel:">Empty</a></body></html>"#);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 0);
}
#[test]
fn test_extract_no_contacts() {
let html = Html::parse_document(
r#"<html><body><a href="https://example.com">Regular link</a></body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 0);
}
#[test]
fn test_extract_case_insensitive() {
let html = Html::parse_document(
r#"<html><body><a href="MAILTO:INFO@EXAMPLE.COM">Email</a></body></html>"#,
);
let links = extract_contact_links(&html);
assert_eq!(links.len(), 1);
assert_eq!(links[0].contact_type, ContactType::Email);
assert_eq!(links[0].value, "INFO@EXAMPLE.COM");
}
}