philiprehberger-email-validate 0.2.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]"

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"

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)

Disposable Email Detection

from philiprehberger_email_validate import validate_email

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

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

API

Function / Class	Description
EmailResult	Dataclass with valid, normalized, domain, error, and is_disposable fields
normalize(email)	Strip whitespace and lowercase an email address
is_valid(email)	Quick boolean syntax check
validate_email(email, check_mx=False)	Full validation returning an EmailResult
validate_many(emails, check_mx=False)	Validate multiple emails with optional parallel MX lookups
DISPOSABLE_DOMAINS	Set of ~50 known disposable email domains

Development

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

Support

If you find this package useful, consider starring the repository.

License

MIT