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("user@example.com")
print(result.valid)       # True
print(result.normalized)  # "user@example.com"
print(result.domain)      # "example.com"

Quick Syntax Check

from philiprehberger_email_validate import is_valid

is_valid("user@example.com")   # True
is_valid("not-an-email")       # False

Normalization

from philiprehberger_email_validate import normalize

normalize("  User@Example.COM  ")          # "user@example.com"
normalize("first.last+tag@gmail.com")      # "firstlast@gmail.com"
normalize("user+promo@example.com")        # "user@example.com"

MX Lookup

from philiprehberger_email_validate import validate_email

result = validate_email("user@example.com", 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("user@mailinator.com")
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("user@tempmail.xyz", 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("info@example.com")
print(result.is_role_based)  # True

is_role_based("admin@example.com")    # True
is_role_based("john@example.com")     # False

Free Provider Detection

Flag consumer/free mailboxes (useful for filtering B2B signups that should use a company address):

from philiprehberger_email_validate import validate_email, is_free_email

result = validate_email("user@gmail.com")
print(result.is_free)  # True

is_free_email("user@gmail.com")        # True
is_free_email("user@acme-corp.com")    # False

Email Domain Suggestions

from philiprehberger_email_validate import validate_email, suggest_domain, suggest_email

result = validate_email("user@gmial.com")
print(result.suggested_domain)  # "gmail.com"

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

# Correct the whole address (local part and any +tag are preserved)
suggest_email("first.last+promo@hotmial.com")  # "first.last+promo@hotmail.com"
suggest_email("user@gmail.com")                # "" (no suggestion needed)

RFC 5321 Strict Mode

from philiprehberger_email_validate import validate_email

result = validate_email("user@example.com", strict=True)
print(result.valid)  # True

result = validate_email(".user@example.com", 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(["user@example.com", "bad@@email", "test@gmail.com"])
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 hello@example.com or support@test.org")
# ["hello@example.com", "support@test.org"]

Email Parts

from philiprehberger_email_validate import email_parts

parts = email_parts("user@example.com")
print(parts.local)   # "user"
print(parts.domain)  # "example.com"
print(parts.tld)     # "com"

Mask Email

from philiprehberger_email_validate import mask_email

mask_email("john@example.com")     # "j***n@example.com"
mask_email("alice@example.com")    # "a***e@example.com"

Disposable check

from philiprehberger_email_validate import is_disposable

is_disposable("user@mailinator.com")   # True
is_disposable("user@gmail.com")        # False
is_disposable("not-an-email")          # False

Comparing emails

from philiprehberger_email_validate import compare_emails

compare_emails("Foo@Gmail.com", "foo@gmail.com")              # True
compare_emails("foo.bar+tag@gmail.com", "foobar@gmail.com")   # True
compare_emails("foo@a.com", "bar@a.com")                      # False

Deduplicating emails

Remove duplicates by normalized form, keeping the first original spelling and input order:

from philiprehberger_email_validate import dedupe_emails

dedupe_emails(["Foo@Gmail.com", "f.oo+news@gmail.com", "bar@example.com"])
# ["Foo@Gmail.com", "bar@example.com"]

Grouping by domain

Invalid addresses are collected under the None key:

from philiprehberger_email_validate import group_by_domain

group_by_domain(["a@Example.com", "b@test.org", "c@example.com", "oops"])
# {"example.com": ["a@Example.com", "c@example.com"], "test.org": ["b@test.org"], None: ["oops"]}

Serializing results

import json
from philiprehberger_email_validate import validate_email

json.dumps(validate_email("user@example.com").to_dict())

API

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