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('[email protected]')
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='[email protected]',
from_host='mydomain.com',
from_email='[email protected]'
)
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
- Not all email servers will return the correct status
- Checking an invalid email address returns within 1 second
- 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.
Commit History @6d47c285-1fa0-462c-8f45-20090ed07c92/main
- Update standards version to 4.6.0, no changes needed. Kali Janitor 1 year, 11 months ago
- Add Uploaders Ben Wilson 2 years ago
- Remove double spaces from Description Ben Wilson 2 years ago
- Update standards version to 4.5.0, no changes needed. Kali Janitor 3 years ago
- Add GitLab's CI configuration file Sophie Brun 4 years ago
- Configure git-buildpackage for Kali Sophie Brun 4 years ago
- Initial release Sophie Brun 4 years ago
- New upstream version 0.1.3 Sophie Brun 4 years ago