Fix documentation
This commit is contained in:
parent
9a8da38b47
commit
452434a81a
2 changed files with 12 additions and 8 deletions
19
README.rst
19
README.rst
|
@ -1,16 +1,16 @@
|
||||||
.. image:: https://travis-ci.org/karolyi/py3-validate-email.svg?branch=master
|
.. image:: https://travis-ci.org/karolyi/py3-validate-email.svg?branch=master
|
||||||
:target: https://travis-ci.org/karolyi/py3-validate-email
|
:target: https://travis-ci.org/karolyi/py3-validate-email
|
||||||
|
|
||||||
==============
|
============================
|
||||||
py3-validate-email
|
py3-validate-email
|
||||||
==============
|
============================
|
||||||
|
|
||||||
py3-validate-email is a package for Python that check if an email is valid, properly formatted and really exists.
|
py3-validate-email is a package for Python that check if an email is valid, properly formatted and really exists.
|
||||||
|
|
||||||
This module is for Python 3.6 and above!
|
This module is for Python 3.6 and above!
|
||||||
|
|
||||||
INSTALLATION
|
INSTALLATION
|
||||||
============
|
============================
|
||||||
|
|
||||||
You can install the package with pip:
|
You can install the package with pip:
|
||||||
|
|
||||||
|
@ -18,17 +18,20 @@ You can install the package with pip:
|
||||||
|
|
||||||
|
|
||||||
USAGE
|
USAGE
|
||||||
=====
|
============================
|
||||||
|
|
||||||
Basic usage::
|
Basic usage::
|
||||||
|
|
||||||
from validate_email import validate_email
|
from validate_email import validate_email
|
||||||
is_valid = validate_email('example@example.com', check_regex=True, check_mx=True)
|
is_valid = validate_email(email_address='example@example.com', check_regex=True, check_mx=True, from_address='my@from.addr.ess', smtp_timeout=10, use_blacklist=True)
|
||||||
|
|
||||||
check_regex will check will the email address has a valid structure and defaults to True
|
`check_regex` will check will the email address has a valid structure and defaults to True
|
||||||
check_mx will check the mx-records and check whether the email actually exists
|
`check_mx`: check the mx-records and check whether the email actually exists
|
||||||
|
`from_address`: the email address the probe will be sent from,
|
||||||
|
`smtp_timeout`: seconds until SMTP timeout
|
||||||
|
`use_blacklist`: use the blacklist of domains downloaded from [https://githubusercontent.com/martenson/disposable-email-domains](https://raw.githubusercontent.com/martenson/disposable-email-domains)
|
||||||
|
|
||||||
|
|
||||||
TODOs and BUGS
|
TODOs and BUGS
|
||||||
==============
|
============================
|
||||||
See: https://github.com/karolyi/py3-validate-email/issues
|
See: https://github.com/karolyi/py3-validate-email/issues
|
||||||
|
|
1
setup.py
1
setup.py
|
@ -33,6 +33,7 @@ setup(
|
||||||
author_email='laszlo@karolyi.hu',
|
author_email='laszlo@karolyi.hu',
|
||||||
description='Email validator with regex and SMTP checking.',
|
description='Email validator with regex and SMTP checking.',
|
||||||
long_description=open('README.rst').read(),
|
long_description=open('README.rst').read(),
|
||||||
|
long_description_content_type='text/x-rst',
|
||||||
keywords='email validation verification mx verify',
|
keywords='email validation verification mx verify',
|
||||||
url='http://github.com/karolyi/py3-validate-email',
|
url='http://github.com/karolyi/py3-validate-email',
|
||||||
cmdclass=dict(build_py=PostBuildPyCommand),
|
cmdclass=dict(build_py=PostBuildPyCommand),
|
||||||
|
|
Loading…
Reference in a new issue