python-disposable 0.0.1__py3-none-any.whl

python_disposable-0.0.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+disposable_email/__init__.py,sha256=DuXCxE_v6huvDitkFAj9H7LmTSl_N0n8Pu63wSPaZes,2902
+disposable_email/_version.py,sha256=qf6R-J7-UyuABBo8c0HgaquJ8bejVbf07HodXgwAwgQ,704
+disposable_email/domains.txt,sha256=yJfrvYQpcIkeGDRpQ_6vbiNzmsiy1iAGvoFh1YxwXqM,1100494
+disposable_email/domains_strict.txt,sha256=3mvYzOMEHjPxClCXbg-2VLLh8r7KOIW1QanL5xjUvMo,378877
+python_disposable-0.0.1.dist-info/METADATA,sha256=Sb-2Gl5qni2Haftnxr__kk_OcPK3DCZBOzHy6qJ0Ibc,2612
+python_disposable-0.0.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_disposable-0.0.1.dist-info/licenses/LICENSE,sha256=kNxBn8lFmkHb4zIM4CKOI7qQRbZ2mBD66jr48Bhu16w,1157
+python_disposable-0.0.1.dist-info/RECORD,,

python_disposable-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

python_disposable-0.0.1.dist-info/licenses/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.