torrust_index_backend/utils/
validation.rs

1use std::str::FromStr;
2
3use email_address::EmailAddress;
4use regex::Regex;
5
6const MIN_DOMAIN_LENGTH: usize = 4;
7
8/// Validates an email address.
9///
10/// # Panics
11///
12/// It panics if the email address is invalid. This should not happen
13/// because the email address is previously validated.
14#[must_use]
15pub fn validate_email_address(email_address_to_be_checked: &str) -> bool {
16    if !EmailAddress::is_valid(email_address_to_be_checked) {
17        return false;
18    }
19
20    let email = EmailAddress::from_str(email_address_to_be_checked).expect("Invalid email address");
21
22    // We reject anyway the email if it's a dotless domain name.
23    domain_has_extension(email.domain())
24}
25
26/// Returns true if the string representing a domain has an extension.
27///
28/// It does not check if the extension is valid.
29fn domain_has_extension(domain: &str) -> bool {
30    if domain.len() < MIN_DOMAIN_LENGTH {
31        return false;
32    }
33
34    Regex::new(r".*\..*").expect("Invalid regex").is_match(domain)
35}
36
37#[cfg(test)]
38mod tests {
39
40    mod for_email_validation {
41        use crate::utils::validation::validate_email_address;
42
43        #[test]
44        fn it_should_accept_valid_email_addresses() {
45            assert!(validate_email_address("test@torrust.com"));
46            assert!(validate_email_address("t@torrust.org"));
47        }
48
49        #[test]
50        fn it_should_not_accept_invalid_email_addresses() {
51            assert!(!validate_email_address("test"));
52            assert!(!validate_email_address("test@"));
53            assert!(!validate_email_address("test@torrust."));
54            assert!(!validate_email_address("test@."));
55            assert!(!validate_email_address("test@.com"));
56
57            // Notice that local domain name with no TLD are valid,
58            // although ICANN highly discourages dotless email addresses
59            assert!(!validate_email_address("test@torrust"));
60        }
61    }
62
63    mod for_domain_validation {
64        use crate::utils::validation::domain_has_extension;
65
66        #[test]
67        fn it_should_accept_valid_domain_with_extension() {
68            assert!(domain_has_extension("a.io"));
69            assert!(domain_has_extension("a.com"));
70        }
71
72        #[test]
73        fn it_should_not_accept_dotless_domains() {
74            assert!(!domain_has_extension(""));
75            assert!(!domain_has_extension("."));
76            assert!(!domain_has_extension("a."));
77        }
78    }
79}
torrust_index_backend/utils/validation.rs

torrust_index_backend/utils/
validation.rs
