python-disposable 0.0.1__tar.gz

python_disposable-0.0.1/.gitignore

@@ -0,0 +1,39 @@
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Build artifacts
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Python cache
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+
+# Distribution / packaging
+*.whl
+*.tar.gz
+MANIFEST
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db

python_disposable-0.0.1/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Pescheck B.V.
+Copyright (c) 2017 Andrei Simionescu
+Copyright (c) 2017 Stefan Meinecke, greenSec GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_disposable-0.0.1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: python-disposable
+Version: 0.0.1
+Summary: Check if an email address or domain belongs to a disposable/temporary email service. Bundles 72k+ domains from disposable/disposable-email-domains.
+Project-URL: Source, https://github.com/disposable/disposable-email-domains
+License: MIT
+License-File: LICENSE
+Keywords: disposable,email,spam,validation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
+# 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](https://github.com/disposable/disposable-email-domains), updated daily.
+
+## Installation
+
+```bash
+pip install disposable-email-check
+```
+
+## Usage
+
+```python
+from disposable_email import is_disposable, is_valid, domain_count
+
+# Check by email address
+is_disposable("user@mailinator.com")  # True
+is_disposable("user@gmail.com")       # False
+
+# Check by domain only
+is_disposable("guerrillamail.com")    # True
+
+# Inverse check
+is_valid("user@gmail.com")            # True
+is_valid("user@10minutemail.com")     # False
+
+# How many domains are bundled?
+domain_count()  # 72170
+```
+
+## Django example
+
+```python
+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](https://github.com/disposable/disposable-email-domains) and updated with each package release.
+
+To update manually, run:
+
+```bash
+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.

python_disposable-0.0.1/README.md

@@ -0,0 +1,60 @@
+# 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](https://github.com/disposable/disposable-email-domains), updated daily.
+
+## Installation
+
+```bash
+pip install disposable-email-check
+```
+
+## Usage
+
+```python
+from disposable_email import is_disposable, is_valid, domain_count
+
+# Check by email address
+is_disposable("user@mailinator.com")  # True
+is_disposable("user@gmail.com")       # False
+
+# Check by domain only
+is_disposable("guerrillamail.com")    # True
+
+# Inverse check
+is_valid("user@gmail.com")            # True
+is_valid("user@10minutemail.com")     # False
+
+# How many domains are bundled?
+domain_count()  # 72170
+```
+
+## Django example
+
+```python
+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](https://github.com/disposable/disposable-email-domains) and updated with each package release.
+
+To update manually, run:
+
+```bash
+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.

python_disposable-0.0.1/disposable_email/__init__.py

@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+from importlib.resources import files
+from typing import Optional
+
+_domains: Optional[frozenset[str]] = None
+_domains_strict: Optional[frozenset[str]] = None
+
+
+def _load(strict: bool = False) -> frozenset[str]:
+    global _domains, _domains_strict
+    if strict:
+        if _domains_strict is None:
+            data = files("disposable_email").joinpath("domains_strict.txt").read_text(encoding="utf-8")
+            _domains_strict = frozenset(line.strip().lower() for line in data.splitlines() if line.strip())
+        return _domains_strict
+    else:
+        if _domains is None:
+            data = files("disposable_email").joinpath("domains.txt").read_text(encoding="utf-8")
+            _domains = frozenset(line.strip().lower() for line in data.splitlines() if line.strip())
+        return _domains
+
+
+def _extract_domain(email_or_domain: str) -> str:
+    """Extract and normalize domain, stripping subdomains if needed."""
+    domain = email_or_domain.split("@")[-1].strip().lower()
+    return domain
+
+
+def _is_disposable_domain(domain: str, strict: bool = False) -> bool:
+    """Check domain and progressively strip subdomains until a match is found."""
+    domains = _load(strict)
+    parts = domain.split(".")
+    # Check from full domain down to second-level domain (e.g. a.b.c.com -> b.c.com -> c.com)
+    for i in range(len(parts) - 1):
+        candidate = ".".join(parts[i:])
+        if candidate in domains:
+            return True
+    return False
+
+
+def is_disposable(email_or_domain: str, strict: bool = False) -> bool:
+    """Return True if the email address or domain is a known disposable/temporary email service.
+
+    Args:
+        email_or_domain: An email address (user@example.com) or bare domain (example.com).
+        strict: If True, also flags greylisted domains (anonymous signup services).
+    """
+    domain = _extract_domain(email_or_domain)
+    if not domain:
+        return False
+    return _is_disposable_domain(domain, strict=strict)
+
+
+def is_valid(email_or_domain: str, strict: bool = False) -> bool:
+    """Return True if the email address or domain is NOT a known disposable/temporary email service.
+
+    Args:
+        email_or_domain: An email address (user@example.com) or bare domain (example.com).
+        strict: If True, also flags greylisted domains (anonymous signup services).
+    """
+    return not is_disposable(email_or_domain, strict=strict)
+
+
+def get_domains(strict: bool = False) -> frozenset[str]:
+    """Return the full set of known disposable domains.
+
+    Args:
+        strict: If True, returns the strict list (includes greylisted domains).
+    """
+    return _load(strict)
+
+
+def domain_count(strict: bool = False) -> int:
+    """Return the number of known disposable domains in the bundled list.
+
+    Args:
+        strict: If True, returns the count for the strict list.
+    """
+    return len(_load(strict))

python_disposable-0.0.1/disposable_email/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.0.1'
+__version_tuple__ = version_tuple = (0, 0, 1)
+
+__commit_id__ = commit_id = None