Metadata-Version: 2.4
Name: tempmail10min
Version: 1.0.1
Summary: Official Python SDK for TempMail10min - High-speed, anonymous disposable temporary email API with customizable 5-30m lifespans.
Author-email: Alfaz Mahmud Rizve <alfaz@temp-mail10min.online>
License: MIT
Project-URL: Homepage, https://temp-mail10min.online
Project-URL: 5-Minute Mail, https://temp-mail10min.online/5-minute-mail
Project-URL: 15-Minute Mail, https://temp-mail10min.online/15-minute-mail
Project-URL: Documentation, https://temp-mail10min.online/about-us
Project-URL: Testing Benchmarks, https://temp-mail10min.online/post/best-disposable-temporary-email-services
Project-URL: Repository, https://github.com/AlfazMahmudRizve/tempmail10min-python
Project-URL: Bug Tracker, https://github.com/AlfazMahmudRizve/tempmail10min-python/issues
Keywords: temp-mail,disposable-email,10-minute-mail,tempmail,testing,otp-verification,qa-automation,privacy
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Communications :: Email
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Security
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# tempmail10min

> Official Python Client SDK for [TempMail10min](https://temp-mail10min.online) &mdash; High-Speed, Anonymous Disposable Email Generator.

[![PyPI version](https://img.shields.io/pypi/v/tempmail10min.svg)](https://pypi.org/project/tempmail10min/)
[![Python versions](https://img.shields.io/pypi/pyversions/tempmail10min.svg)](https://pypi.org/project/tempmail10min/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Website](https://img.shields.io/badge/Website-temp--mail10min.online-green)](https://temp-mail10min.online)

A lightweight, zero-dependency Python library for generating temporary email addresses, receiving OTP verification codes, and automating QA signup flows.

---

## Features
- **Customizable Lifespans:** Create temporary inboxes lasting 5, 10, 15, 20, 25, or 30 minutes.
- **Zero External Dependencies:** Built using Python's standard `urllib.request` library.
- **Automated Polling:** Built-in `wait_for_message()` helper with configurable timeout.
- **RAM-Only Processing:** Volatile memory deletion guaranteed upon lifespan expiry.

---

## Installation

```bash
pip install tempmail10min
```

---

## Quickstart

```python
from tempmail10min import TempMail10min

# Initialize client with 15-minute lifespan
client = TempMail10min(duration=15)

# 1. Generate a disposable temporary inbox
mailbox = client.create_mailbox()
print(f"Active Temporary Email: {mailbox['email']}")

# 2. Wait for incoming verification email / OTP (polling helper)
print("Waiting for incoming verification message...")
message = client.wait_for_message(timeout=60, poll_interval=3)

print(f"Sender: {message.get('sender')}")
print(f"Subject: {message.get('subject')}")
print(f"Body: {message.get('body_text')}")
```

## Supported Lifespan Endpoints & Web Tools
For interactive testing or webmail access across custom countdown durations, use the official web utilities:
* **[5 Minute Mail (Fast OTP Bypass)](https://temp-mail10min.online/5-minute-mail):** Rapid 300-second mailbox for instant SMS/OTP code capture.
* **[10 Minute Mail (Standard)](https://temp-mail10min.online/):** Default ephemeral inbox for general verification flows.
* **[15 Minute Mail (Extended Buffer)](https://temp-mail10min.online/15-minute-mail):** 900-second lifespan designed for slow third-party email delivery queues.
* **[20 Minute Mail (Developer Testing)](https://temp-mail10min.online/20-minute-mail):** 1,200-second session for multi-step signup validation.
* **[25 Minute Mail (Long Forms)](https://temp-mail10min.online/25-minute-mail):** Extended session for complex registrations and surveys.
* **[30 Minute Mail (Half-Hour)](https://temp-mail10min.online/30-minute-mail):** Full 1,800-second disposable inbox for webinars and trials.

---

## Technical Guides & Testing Benchmarks
* **[8 Best Disposable Temp Mail Services Tested](https://temp-mail10min.online/post/best-disposable-temporary-email-services):** Empirical delivery speed benchmarks comparing leading disposable email providers.
* **[What Is a Disposable Email Address & How It Works](https://temp-mail10min.online/post/what-is-disposable-email):** Technical architecture of volatile RAM-only ephemeral mail routing.
* **[Why Websites Block Temporary Email & How to Fix It](https://temp-mail10min.online/post/why-websites-block-temporary-email):** Analysis of MX heuristics, greylisting delays, and verification filters.
* **[Engineering & Privacy Architecture](https://temp-mail10min.online/about-us):** Overview of our Postfix MTA, Redis volatile memory caches, and zero-log guarantees.

---

## License
MIT License © [TempMail10min](https://temp-mail10min.online)
