././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674365137.6825805 python-emailahoy3-0.1.3/0000755000174500017450000000000014363144322015035 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/LICENSE.md0000644000174500017450000000312213501256242016435 0ustar00janitorjanitorCopyright © Val Neekman ([Neekware Inc.](http://neekware.com)) [ info@neekware.com, [@vneekman](https://twitter.com/vneekman) ] All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. Neither the name of this project nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674365137.6825805 python-emailahoy3-0.1.3/PKG-INFO0000644000174500017450000000465614363144322016145 0ustar00janitorjanitorMetadata-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 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 License-File: LICENSE.md 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('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.md)) license. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/README.md0000644000174500017450000000340013501256242016307 0ustar00janitorjanitorPython 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('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.md)) license. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674365137.6825805 python-emailahoy3-0.1.3/emailahoy3/0000755000174500017450000000000014363144322017070 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/emailahoy3/__init__.py0000644000174500017450000001740213501256242021203 0ustar00janitorjanitor__version__ = '0.1.3' import logging import os import re import sys import socket from subprocess import check_output import smtplib as _smtp from emailahoy3.exceptions import UnableToVerifyException from emailahoy3.exceptions import HostSystemNotSupportedException DEBUG = False __all__ = ['VerifyEmail', 'verify_email_address', 'query_mx'] MX_RE = re.compile('mail\sexchanger\s=\s(\d+)\s(.*)\.') EMAIL_RE = re.compile('([\w\-\.+]+@\w[\w\-]+\.+[\w\-]+)') NOT_FOUND_KEYWORDS = [ "does not exist", "doesn't exist", "doesn't have", "doesn't handle", "unknown user", "user unknown", "disabled", "discontinued", "unavailable", "unknown", "invalid", "typos", "unnecessary spaces", ] UNVERIFIABLE_KEYWORDS = [ "block", "block list", "spam", "spammer", "isp", "weren't sent", "not accepted", "Spamhaus", "suspicious", "Denied by policy", "banned sending IP", "sender.office.com" ] def query_mx(host): """Returns all MX records of a given domain name Args: host (str): The hostname of the email address. Returns: List of email exchangers. Raises: HostSystemNotSupportedException. """ mail_exchangers = [] addr = {} # The 'which nslookup' will not work in Windows systems if os.name != "nt": # Get the existence of nslookup fout = check_output(['which', 'nslookup']).decode() cmd = fout.strip() if cmd != '': # Get the text from the nslookup when querying the mail exchanger fout = check_output([cmd, '-query=mx', host]).decode().splitlines() for line in fout: mx = MX_RE.search(line.lower()) if mx: mail_exchangers.append((eval(mx.group(1)), mx.group(2))) if mail_exchangers: mail_exchangers.sort() else: raise HostSystemNotSupportedException() return mail_exchangers class VerifyEmail(object): """Verify if email exists""" EMAIL_FOUND = 1 EMAIL_NOT_FOUND = 0 UNABLE_TO_VERIFY = -1 def connect(self, hostname, timeout=5): """Returns a server connection or None given a hostname""" try: socket.gethostbyname(hostname) server = _smtp.SMTP(timeout=timeout) code, resp = server.connect(hostname) if code == 220: return server except: pass return None def unverifiable(self, resp): """Return true if email is not verifiable """ return any(a in str(resp).lower() for a in UNVERIFIABLE_KEYWORDS) def nonexistent(self, resp): """Return true if email is not found """ return any(a in str(resp).lower() for a in NOT_FOUND_KEYWORDS) def verify( self, email, from_host='example.com', from_email='verify@example.com' ): """Verifies wether an email address exists Args: email (str): Email to verify. from_host (str): Host to be used to verify. from_email (str): Email to be used to verify. Return: bool. Raises: HostSystemNotSupportedException. UnableToVerifyException. """ if DEBUG: logging.basicConfig(level=logging.DEBUG) else: logging.basicConfig(level=logging.INFO) if not EMAIL_RE.search(email): logging.debug(f"'{email}' is not a valid email") return self.EMAIL_NOT_FOUND try: hostname = email.strip().split('@')[1] socket.gethostbyname(hostname) mail_exchangers = query_mx(hostname) except Exception as e: logging.debug(e) raise e logging.debug(f"Found mail exchangers: {mail_exchangers}") for i, mx in enumerate(mail_exchangers): mx_name = mx[1] logging.debug(f"Testing {mx_name} (#{i})...") logging.debug(f"\tConnecting to {mx_name}") server = self.connect(mx_name) if not server: logging.debug("\tCould not get connected to server.") continue if DEBUG: server.set_debuglevel(1) logging.debug("\tDo helo...") try: code, resp = server.helo(mx_name) if code != 250: if not self.unverifiable(resp): raise UnableToVerifyException() continue except: pass logging.debug("\tDo mail:") try: code, resp = server.mail(from_email) logging.debug(f"Code: {code}") logging.debug(f"Response: {resp}") if code != 250: if not self.unverifiable(resp): raise UnableToVerifyException() continue except: pass try: logging.debug("\tDo rcpt:") code, resp = server.rcpt(email) logging.debug(f"\t\tCode: {code}") logging.debug(f"\t\tResponse: {resp}") if code != 250: if self.nonexistent(resp): return self.EMAIL_NOT_FOUND elif self.unverifiable(resp): raise UnableToVerifyException() else: continue except: pass try: logging.debug("\tDo data:") code, resp = server.data('Ahoy. Are you there? Testing my python3 port of the package ;) {0}.{0}'.format(_smtp.CRLF)) logging.debug(f"\t\tCode: {code}") logging.debug(f"\t\tResponse: {resp}") if code != 250: if self.nonexistent(resp): return self.EMAIL_NOT_FOUND elif self.unverifiable(resp): raise UnableToVerifyException() elif code == 250: return self.EMAIL_FOUND except: pass raise UnableToVerifyException() # given an email it returns True if it can tell it exist or False def verify_email_address( email, from_host='i3visio.com', from_email='verify@i3visio.com' ): """A quick email verification fuction Args: email (str): Email to verify. from_host (str): Host to be used to verify. from_email (str): Email to be used to verify. Returns: int. 1 for existing emails; 0, for non existing and -1 when it is impossible to verify. """ e = VerifyEmail() try: status = e.verify(email, from_host, from_email) if status == e.EMAIL_FOUND: return 1 except Exception: return -1 return 0 if __name__ == "__main__": # if verify_email_address('un33kvu@gmail.com', 'djanguru.djanguru.net', 'verify@djanguru.net'): # if verify_email_address('un33ksssddsdsd333vu@gmail.com', 'djanguru.net', 'verify@djanguru.net'): # if verify_email_address('un33kvu@yahoo.com', 'djanguru.net', 'verify@djanguru.net'): # if verify_email_address('un33ksssddsdsd333vu@yahoo.com', 'djanguru.net', 'verify@djanguru.net'): # if verify_email_address('un33ksssddsdsd333vu@cnn.com', 'djanguru.net', 'verify@djanguru.net'): # if verify_email_address('vman@outsourcefactor.com', 'djanguru.net', 'verify@djanguru.net'): status = verify_email_address('asfsadfasfsdf@gmail.com', 'i3visio.com', 'sayhello@i3visio.com') if status == 1: print("Email found!") elif status == 0: print("Email not found!") else: print("Email could not be verified!") ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/emailahoy3/email.py0000644000174500017450000000010513501256242020523 0ustar00janitorjanitor# -*- coding: utf-8 -*- __version__ = '0.1.3' from .email import * ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/emailahoy3/exceptions.py0000644000174500017450000000036713501256242021627 0ustar00janitorjanitorimport os class UnableToVerifyException(Exception): """It was impossible to verify the existence of this email""" class HostSystemNotSupportedException(Exception): f"""The host system ('{os.name}') is not supported for this package""" ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674365137.6825805 python-emailahoy3-0.1.3/python_emailahoy3.egg-info/0000755000174500017450000000000014363144322022163 5ustar00janitorjanitor././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674365137.0 python-emailahoy3-0.1.3/python_emailahoy3.egg-info/PKG-INFO0000644000174500017450000000465614363144321023272 0ustar00janitorjanitorMetadata-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 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 License-File: LICENSE.md 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('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.md)) license. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674365137.0 python-emailahoy3-0.1.3/python_emailahoy3.egg-info/SOURCES.txt0000644000174500017450000000040514363144321024045 0ustar00janitorjanitorLICENSE.md README.md setup.py emailahoy3/__init__.py emailahoy3/email.py emailahoy3/exceptions.py python_emailahoy3.egg-info/PKG-INFO python_emailahoy3.egg-info/SOURCES.txt python_emailahoy3.egg-info/dependency_links.txt python_emailahoy3.egg-info/top_level.txt././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674365137.0 python-emailahoy3-0.1.3/python_emailahoy3.egg-info/dependency_links.txt0000644000174500017450000000000114363144321026230 0ustar00janitorjanitor ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1674365137.0 python-emailahoy3-0.1.3/python_emailahoy3.egg-info/top_level.txt0000644000174500017450000000001314363144321024706 0ustar00janitorjanitoremailahoy3 ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1674365137.6825805 python-emailahoy3-0.1.3/setup.cfg0000644000174500017450000000004614363144322016656 0ustar00janitorjanitor[egg_info] tag_build = tag_date = 0 ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1560632482.0 python-emailahoy3-0.1.3/setup.py0000755000174500017450000000502613501256242016553 0ustar00janitorjanitor#!/usr/bin/env python # -*- coding: utf-8 -*- from setuptools import setup import re import os import sys name = 'python-emailahoy3' package = 'emailahoy3' description = 'A Python3 email utility that verifies existence of an email address' url = 'https://github.com/febrezo/python-emailahoy3' author = 'Val Neekman and Félix Brezo' author_email = 'felix.brezo@i3visio.com' license = 'BSD' install_requires = [] classifiers = [ 'Development Status :: 3 - Alpha', 'Intended Audience :: Developers', 'License :: OSI Approved :: BSD License', 'Operating System :: POSIX', 'Programming Language :: Python', 'Topic :: Software Development :: Libraries :: Python Modules', 'Topic :: Communications :: Email', ] def read(fname): return open(os.path.join(os.path.dirname(__file__), fname)).read() def get_version(package): """ Return package version as listed in `__version__` in `init.py`. """ init_py = open(os.path.join(package, '__init__.py')).read() return re.search("^__version__ = ['\"]([^'\"]+)['\"]", init_py, re.MULTILINE).group(1) def get_packages(package): """ Return root package and all sub-packages. """ return [dirpath for dirpath, dirnames, filenames in os.walk(package) if os.path.exists(os.path.join(dirpath, '__init__.py'))] def get_package_data(package): """ Return all files under the root package, that are not in a package themselves. """ walk = [(dirpath.replace(package + os.sep, '', 1), filenames) for dirpath, dirnames, filenames in os.walk(package) if not os.path.exists(os.path.join(dirpath, '__init__.py'))] filepaths = [] for base, filenames in walk: filepaths.extend([os.path.join(base, filename) for filename in filenames]) return {package: filepaths} if sys.argv[-1] == 'publish': os.system("python setup.py sdist upload") args = {'version': get_version(package)} print("You probably want to also tag the version now:") print(" git tag -a %(version)s -m 'version %(version)s'" % args) print(" git push --tags") sys.exit() setup( name=name, version=get_version(package), url=url, license=license, description=description, long_description=read('README.md'), long_description_content_type="text/markdown", author=author, author_email=author_email, packages=get_packages(package), package_data=get_package_data(package), install_requires=install_requires, classifiers=classifiers )