philiprehberger-email-validate 0.3.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"})

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
results = validate_many(emails, check_mx=True, concurrent=True)

API

Function / Class	Description
EmailResult	Dataclass with valid, normalized, domain, error, and is_disposable 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)	Full validation returning an EmailResult
validate_many(emails, check_mx, concurrent, extra_disposable)	Validate multiple emails with optional parallel MX lookups
set_disposable_domains(domains)	Merge additional domains into the global disposable domains set
DISPOSABLE_DOMAINS	Mutable set of known disposable email domains

Development

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

Support

If you find this package useful, consider giving it a star on GitHub — it helps motivate continued maintenance and development.

License

MIT