python-emailahoy3 0.1.1

A Python3 email utility that verifies existence of an email address

Python Email Ahoy 3

A Python email utility that verifies existence of an email address

[![build-status-image-fury]][fury] [![build-status-image-pypi]][pypi]

Overview

A Python email utility that verifies existence of an email address. This package is based on this package which only run in Python 2. It has been refactored to work in Python 3.

How to install

Use Pip (note that it works only for Python 3.6+ sicne it uses f-strings):

pip3 install python-emailahoy3 --user

How to use

Use the class for more control & more granular return status:

from emailahoy3 import VerifyEmail
e = VerifyEmail()
status = e.verify_email_smtp(
                    email='[e-mail]',
                    from_host='mydomain.com',
                    from_email='[e-mail]'
                )
if e.was_found(status):
    print >> sys.stderr, "Found:", status
elif e.not_found(status):
    print >> sys.stderr, "Not Found:", status
else:
    print >> sys.stderr, "Unverifiable:", status

Use the shorthand function for quick check:

from emailahoy3 import verify_email_address
if verify_email_address('[e-mail]'):
    print >> sys.stderr, "Found"
else:
    print >> sys.stderr, "Don't care"

Notes

1. Not all email servers will return the correct status
2. Checking an invalid email address returns within 1 second
3. Checking a valid email address returns within 4 seconds or more

Running the tests

To run the tests against the current environment:

python3 -m unittest discover

License

Released under a (BSD) license.