Metadata-Version: 2.1
Name: python-emailahoy3
Version: 0.1.3
Summary: A Python3 email utility that verifies existence of an email address
Home-page: https://github.com/febrezo/python-emailahoy3
Author: Val Neekman and FĂ©lix Brezo
Author-email: felix.brezo@i3visio.com
License: BSD
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](https://github.com/un33k/python-emailahoy) 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
=================
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.md)) license.
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications :: Email
Description-Content-Type: text/markdown