python-disposable 0.0.2

Check if an email address or domain belongs to a disposable/temporary email service. Bundles 72k+ domains from disposable/disposable-email-domains.

python-disposable

A Python package to check if an email address or domain belongs to a disposable/temporary email service.

Bundles 72,000+ domains from disposable/disposable-email-domains, updated daily.

Installation

pip install python-disposable

Usage

from disposable_email import is_disposable, is_valid, domain_count

# Check by email address
is_disposable("[e-mail]")  # True
is_disposable("[e-mail]")       # False

# Check by domain only
is_disposable("guerrillamail.com")    # True

# Inverse check
is_valid("[e-mail]")            # True
is_valid("[e-mail]")     # False

# How many domains are bundled?
domain_count()  # 72170

Django example

from django import forms
from disposable_email import is_disposable

class RegisterForm(forms.Form):
    email = forms.EmailField()

    def clean_email(self):
        email = self.cleaned_data["email"]
        if is_disposable(email):
            raise forms.ValidationError("Disposable email addresses are not allowed.")
        return email

Updating the domain list

The bundled domains.txt is sourced from disposable/disposable-email-domains and updated with each package release.

To update manually, run:

curl -sL https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt \
  -o disposable_email/domains.txt

Then bump the version in pyproject.toml and re-publish.