Metadata-Version: 1.0
Name: django-disposable-email-checker
Version: 0.1.1
Summary: Python class for use with Django to detect Disposable Emails
Home-page: https://github.com/aaronbassett/DisposableEmailChecker
Author: Aaron Bassett
Author-email: me@aaronbassett.com
License: MIT License
Description: DisposableEmailChecker
        ======================
        
        Python class for use with Django to detect Disposable Emails. Checks each email against a blacklist of ~890 domains used by various disposable email services.
        
        Installation
        ------------
        
        It's an ordinary Python package, just install via ``pip``::
        
        $ pip install git+ssh://git@github.com/aaronbassett/DisposableEmailChecker.git
        
        Download the example disposable email domains list or create your own and update ``settings.py``::
        
        $ cd /usr/share/
        $ wget https://raw.github.com/aaronbassett/DisposableEmailChecker/master/disposable_email_domains.txt
        
        Required Setting
        ----------------
        
        Add the following setting to your Django ``settings.py``::
        
        DISPOSABLE_EMAIL_DOMAINS = "/usr/share/disposable_email_domains.txt"
        
        Usage
        --------
        
        To use the checker in your own scripts::
        
        >>> from disposable_email_checker import DisposableEmailChecker
        
        >>> email_checker = DisposableEmailChecker()
        >>> email_checker.is_disposable("foo@guerrillamail.com")
        True
        
        Using with Django
        -----------------
        
        To use the checker during form validation, normally in ``forms.py``::
        
        from django import forms
        from django.utils.translation import ugettext_lazy as _
        from disposable_email_checker import DisposableEmailChecker
        
        
        class MyForm(forms.Form):
        email = forms.EmailField(label=_('Email'))
        
        def clean_email(self):
        email_checker = DisposableEmailChecker()
        if email_checker.is_disposable(email):
        raise forms.ValidationError(_('Please use a different email address provider.'))
        
        return email
        
        License
        -------
        
        MIT: http://aaron.mit-license.org
Keywords: django email disposable validation
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Framework :: Django
