philiprehberger-email-validate 0.5.0

Email validation with syntax checking and normalization.

philiprehberger-email-validate

Email validation with syntax checking and normalization.

Installation

pip install philiprehberger-email-validate

Usage

from philiprehberger_email_validate import validate_email

result = validate_email("[e-mail]")
print(result.valid)       # True
print(result.normalized)  # "[e-mail]"
print(result.domain)      # "example.com"

Quick Syntax Check

from philiprehberger_email_validate import is_valid

is_valid("[e-mail]")   # True
is_valid("not-an-email")       # False

Normalization

from philiprehberger_email_validate import normalize

normalize("  [e-mail]  ")          # "[e-mail]"
normalize("[e-mail]")      # "[e-mail]"
normalize("[e-mail]")        # "[e-mail]"

MX Lookup

from philiprehberger_email_validate import validate_email

result = validate_email("[e-mail]", check_mx=True)
if not result.valid:
    print(result.error)  # "MX lookup failed for domain: example.com"

Disposable Email Detection

from philiprehberger_email_validate import validate_email

result = validate_email("[e-mail]")
print(result.is_disposable)  # True

Custom Disposable Domains

from philiprehberger_email_validate import validate_email, set_disposable_domains

# Per-call extra domains
result = validate_email("[e-mail]", extra_disposable=["tempmail.xyz"])
print(result.is_disposable)  # True

# Global merge with built-in list
set_disposable_domains({"tempmail.xyz", "fakeemail.org"})

Role-Based Email Detection

from philiprehberger_email_validate import validate_email, is_role_based

result = validate_email("[e-mail]")
print(result.is_role_based)  # True

is_role_based("[e-mail]")    # True
is_role_based("[e-mail]")     # False

Email Domain Suggestions

from philiprehberger_email_validate import validate_email, suggest_domain

result = validate_email("[e-mail]")
print(result.suggested_domain)  # "gmail.com"

suggest_domain("hotmial.com")   # "hotmail.com"
suggest_domain("gmail.com")     # "" (no suggestion needed)

RFC 5321 Strict Mode

from philiprehberger_email_validate import validate_email

result = validate_email("[e-mail]", strict=True)
print(result.valid)  # True

result = validate_email("[e-mail]", strict=True)
print(result.valid)  # False
print(result.error)  # "Local part starts or ends with a dot (RFC 5321)"

Bulk Validation

from philiprehberger_email_validate import validate_many

results = validate_many(["[e-mail]", "bad@@email", "[e-mail]"])
for r in results:
    print(r.normalized, r.valid)

# With concurrent MX lookups and strict mode
results = validate_many(emails, check_mx=True, concurrent=True, strict=True)

Extract Emails from Text

from philiprehberger_email_validate import extract_emails

emails = extract_emails("Contact [e-mail] or [e-mail]")
# ["[e-mail]", "[e-mail]"]

Email Parts

from philiprehberger_email_validate import email_parts

parts = email_parts("[e-mail]")
print(parts.local)   # "user"
print(parts.domain)  # "example.com"
print(parts.tld)     # "com"

Mask Email

from philiprehberger_email_validate import mask_email

mask_email("[e-mail]")     # "j***[e-mail]"
mask_email("[e-mail]")    # "a***[e-mail]"

API

Function / Class	Description
EmailResult	Dataclass with valid, normalized, domain, error, is_disposable, is_role_based, and suggested_domain fields
normalize(email)	Normalize an email: lowercase, strip whitespace, Gmail dot-insensitivity, plus-addressing cleanup
is_valid(email)	Quick boolean syntax check
validate_email(email, check_mx, extra_disposable, strict)	Full validation returning an EmailResult
validate_many(emails, check_mx, concurrent, extra_disposable, strict)	Validate multiple emails with optional parallel MX lookups
is_role_based(email)	Check if an email uses a role-based local part (info@, admin@, etc.)
suggest_domain(domain)	Suggest a corrected domain for common typos
set_disposable_domains(domains)	Merge additional domains into the global disposable domains set
DISPOSABLE_DOMAINS	Mutable set of known disposable email domains
ROLE_PREFIXES	Frozen set of known role-based email prefixes
COMMON_DOMAINS	Frozen set of common email provider domains used for suggestions
extract_emails(text)	Extract all valid email addresses from text, deduplicated
email_parts(email)	Split email into structured parts (local, domain, tld, normalized)
EmailParts	Dataclass with local, domain, tld, normalized fields
mask_email(email, mask_char, visible)	Mask the local part for privacy display

Development

pip install -e .
python -m pytest tests/ -v

Support

If you find this project useful:

⭐ Star the repo

🐛 Report issues

💡 Suggest features

❤️ Sponsor development

🌐 All Open Source Projects

💻 GitHub Profile

🔗 LinkedIn Profile

License

MIT