Skip to main content

A Python3 email utility that verifies existence of an email address

Project description

Python Email Ahoy 3

A Python email utility that verifies existence of an email address

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 shorthand function for quick check:

from emailahoy3 import verify_email_address
status =verify_email_address('test@example.com')
print(status)

Codes are defined as follows:

  • 1. The email exists.
  • 0. The email does not exist.
  • -1. The existence of the email could not be verified.

You can also use the class for more control & more granular return status:

from emailahoy3 import VerifyEmail
e = VerifyEmail()
status = e.verify_email_smtp(
                    email='test@example.com',
                    from_host='mydomain.com',
                    from_email='verify@mydomain.com'
                )
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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-emailahoy3, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size python-emailahoy3-0.1.3.tar.gz (7.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page