Metadata-Version: 2.0
Name: validate-email-wt
Version: 1.4.3
Summary: validate_email verifies if an email address is valid and really exists.
Home-page: https://github.com/wtayyeb/validate_email
Author: w.Tayyeb
Author-email: w.tayyeb@gmail.com
License: LGPL
Keywords: email validation verification mx verify
Platform: UNKNOWN

=================
validate_email_wt
=================

Validate_email is a package for Python that check if an email is valid, properly formatted and really exists.



INSTALLATION
============

First, you must do::

    pip install validate_email_wt

Extra
------

For check the domain mx and verify email exits you must have the `pyDNS` package installed::

    pip install pyDNS


USAGE
=====

Basic usage::

    from validate_email import validate_email
    is_valid = validate_email('example@example.com')


Checking domain has SMTP Server
-------------------------------

Check if the host has SMTP Server::

    from validate_email import validate_email
    is_valid = validate_email('example@example.com',check_mx=True)


Verify email exists
-------------------

Check if the host has SMTP Server and the email really exists::

    from validate_email import validate_email
    is_valid = validate_email('example@example.com',verify=True)

Verify email exists on a server that implements callback verfication
-------------------

Check if the host has SMTP Server and the email really exists::

    from validate_email import validate_email
    is_valid = validate_email('example@example.com',verify=True,sending_email="valid@example.org")

valid@example.org must be a valid e-mail that you control.

For information on callback verification see: https://en.wikipedia.org/wiki/Callback_verification

Don't allow your users to register with disposable emails
---------------------------------------------------------

Checks are performed against this version of the listing:
https://github.com/martenson/disposable-email-domains/tree/4efb0b0ed43022a78abc768c4f28ba7ed7a37772

    from validate_email import validate_email
    is_valid = validate_email("disposable@yopmail.com", allow_disposable=False)
    assert not is_valid


TODOs and BUGS
==============
See: http://github.com/syrusakbary/validate_email/issues


