Metadata-Version: 2.4
Name: nenzmail
Version: 1.0.0
Summary: Free disposable email API client — create temp inboxes, receive emails, and send emails. No auth required.
Author: NenzMail
License: MIT
Project-URL: Homepage, https://nenzmail.xyz
Project-URL: Repository, https://github.com/AyuTriphasari/nenzmail
Project-URL: Bug Tracker, https://github.com/AyuTriphasari/nenzmail/issues
Keywords: temp-mail,tempmail,disposable-email,throwaway-email,burner-email,anonymous-email,email-api,send-email,nenzmail,temporary-email
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.8
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# NenzMail — Free Disposable Email API Client (Python)

Send and receive disposable emails from your Python apps. **No authentication, no API keys, no signup.** Uses only the standard library — no dependencies.

## Install

```bash
pip install nenzmail
```

## Quick Start

```python
import nenzmail

# Create a temp inbox
inbox = nenzmail.create_inbox()
print(inbox['email'])  # purplecat209@nenzmail.xyz

# Check for emails
result = nenzmail.get_emails(inbox['email'])
print(result['emails'])

# Read full email
email = nenzmail.get_email(result['emails'][0]['id'])

# Send an email — free!
nenzmail.send_email(
    from_addr=inbox['email'],
    to='friend@gmail.com',
    subject='Hello from NenzMail',
    text='This was sent from a free temp inbox!',
)

# Delete inbox when done
nenzmail.delete_inbox(inbox['email'])
```

## API

### `create_inbox(domain='nenzmail.xyz', username=None)`
Create a new temporary inbox. Auto-deletes after 1 hour.
- `domain` — `nenzmail.xyz` (default), `nzmail.xyz`, or `zlkcyber.xyz`
- `username` — Custom username (3-30 chars: letters, numbers, `_` or `-`)

### `get_emails(address)`
List all emails in an inbox. Returns `{'emails': [...]}`.

### `get_email(email_id)`
Read full email content (HTML + text).

### `send_email(from_addr, to, subject, text='', html='', reply_to=None)`
Send an email from your inbox to any address. Rate limited: 20/hr per inbox.

### `delete_inbox(address)`
Delete an inbox immediately.

### `get_sent_emails(address)`
Get sent emails (outbox) for an inbox.

### `check_username(username, domain='nenzmail.xyz')`
Check if a custom username is available.

### `get_domains()`
List available domains.

## Features

- 🆓 **100% Free** — no costs, no credit card
- 🔓 **No Auth** — no API keys, no tokens
- 📧 **Send & Receive** — most temp mail only receives
- ⏱️ **Auto-Delete** — inboxes expire after 1 hour
- 📦 **Zero Dependencies** — uses only Python standard library

## Links

- [API Docs](https://nenzmail.xyz/api-docs)
- [Free Send Email](https://nenzmail.xyz/send-email-free)
- [GitHub](https://github.com/AyuTriphasari/nenzmail)

## License

MIT
