Mailchecker

Warnings

• breaking The API for Python was normalized in a major update (between v1.x and v3.x). Previously, you might have instantiated `m = MailChecker.MailChecker()`. The current recommended usage directly calls the class method `MailChecker.is_valid(email)`.
  Fix: Update your code to directly use `MailChecker.is_valid(email)` after `import MailChecker`.
• gotcha Mailchecker primarily focuses on identifying temporary/disposable email domains and basic email format validation. It does *not* perform full SMTP validation to confirm if a mailbox actually exists or is active. An email might pass `is_valid()` but still not be deliverable.
  Fix: For comprehensive email deliverability checks, consider combining Mailchecker with a dedicated email validation service or library that performs MX record lookups and SMTP checks (e.g., `email-validator` library for more syntax/domain checks, or an external API for full deliverability).
• gotcha Older documentation or examples might suggest copying `MailChecker.py` directly into your project. While this might still work for some versions, the recommended and most reliable installation method for the Python package is `pip install mailchecker`.
  Fix: Always install the library via `pip install mailchecker` to ensure you get the latest official version and proper dependency management.

Install

• pip install mailchecker Install with pip

Imports

• MailChecker

  import MailChecker

  The MailChecker object is directly available after `import MailChecker` and its `is_valid` method is a class method. Older versions (pre v3.x) might have required instantiation.

Quickstart

This quickstart demonstrates how to import the `MailChecker` module and use its `is_valid()` method to check various email addresses. It returns `True` if the email is syntactically valid and not on the disposable email domain blacklist, otherwise `False`.

import MailChecker

# Check a valid, non-disposable email
is_valid_real = MailChecker.is_valid('test@example.com')
print(f"'test@example.com' is valid: {is_valid_real}")

# Check a disposable email (yopmail.com is a common one)
is_valid_temp = MailChecker.is_valid('temp@yopmail.com')
print(f"'temp@yopmail.com' is valid: {is_valid_temp}")

# Check an invalid format email
is_valid_format = MailChecker.is_valid('invalid-email')
print(f"'invalid-email' is valid: {is_valid_format}")