nenzmail 1.0.0__tar.gz

nenzmail-1.0.0/PKG-INFO

@@ -0,0 +1,106 @@
+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

nenzmail-1.0.0/README.md

@@ -0,0 +1,83 @@
+# 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

nenzmail-1.0.0/nenzmail.egg-info/PKG-INFO

@@ -0,0 +1,106 @@
+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

nenzmail-1.0.0/nenzmail.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+nenzmail.py
+pyproject.toml
+nenzmail.egg-info/PKG-INFO
+nenzmail.egg-info/SOURCES.txt
+nenzmail.egg-info/dependency_links.txt
+nenzmail.egg-info/top_level.txt

nenzmail-1.0.0/nenzmail.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nenzmail-1.0.0/nenzmail.egg-info/top_level.txt

@@ -0,0 +1 @@
+nenzmail

nenzmail-1.0.0/nenzmail.py

@@ -0,0 +1,162 @@
+"""
+NenzMail — Free disposable email API client for Python.
+No authentication required. Inboxes auto-delete after 1 hour.
+
+Example:
+    import nenzmail
+    inbox = nenzmail.create_inbox()
+    emails = nenzmail.get_emails(inbox['email'])
+    nenzmail.send_email(from=inbox['email'], to='friend@gmail.com',
+                        subject='Hi', text='Hello!')
+"""
+
+import json
+import urllib.request
+import urllib.error
+import urllib.parse
+from typing import Optional, List, Dict, Any
+
+BASE_URL = "https://api.nenzmail.xyz"
+
+
+def _request(method: str, path: str, body: Optional[dict] = None) -> Any:
+    url = f"{BASE_URL}{path}"
+    data = json.dumps(body).encode() if body else None
+    req = urllib.request.Request(url, data=data, method=method)
+    req.add_header("Content-Type", "application/json")
+    req.add_header("User-Agent", "nenzmail-python/1.0")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except urllib.error.HTTPError as e:
+        err_body = e.read().decode()[:200]
+        try:
+            err_json = json.loads(err_body)
+            raise Exception(err_json.get("error", f"HTTP {e.code}")) from e
+        except (json.JSONDecodeError, ValueError):
+            raise Exception(f"HTTP {e.code}: {err_body}") from e
+
+
+def create_inbox(domain: str = "nenzmail.xyz", username: Optional[str] = None) -> Dict:
+    """
+    Create a new temporary inbox. Auto-deletes after 1 hour.
+
+    Args:
+        domain: Domain for the inbox (nenzmail.xyz, nzmail.xyz, zlkcyber.xyz)
+        username: Custom username (3-30 chars: letters, numbers, _ or -)
+
+    Returns:
+        Dict with 'email', 'expiresAt', 'ttl'
+    """
+    body = {"domain": domain}
+    if username:
+        body["username"] = username
+    return _request("POST", "/api/inbox/create", body)
+
+
+def get_emails(address: str) -> Dict:
+    """
+    List all emails in an inbox.
+
+    Args:
+        address: The inbox email address
+
+    Returns:
+        Dict with 'emails' list (id, from, subject, date, hasAttachments)
+    """
+    return _request("GET", f"/api/inbox/{urllib.parse.quote(address)}/emails")
+
+
+def get_email(email_id: str) -> Dict:
+    """
+    Read full email content (HTML + text).
+
+    Args:
+        email_id: The email ID
+
+    Returns:
+        Dict with 'email' object (id, from, to, subject, html, text, date)
+    """
+    return _request("GET", f"/api/email/{urllib.parse.quote(email_id)}")
+
+
+def send_email(
+    from_addr: str,
+    to: str,
+    subject: str,
+    text: str = "",
+    html: str = "",
+    reply_to: Optional[str] = None,
+) -> Dict:
+    """
+    Send an email from your NenzMail inbox to any address.
+    Rate limited: 20/hr per inbox. Sender inbox must be active.
+
+    Args:
+        from_addr: Your NenzMail inbox address
+        to: Recipient email address
+        subject: Email subject
+        text: Plain text body
+        html: HTML body (optional)
+        reply_to: Reply-to address (optional)
+
+    Returns:
+        Dict with 'success', 'id', 'subdomain', 'fromEmail'
+    """
+    body = {"from": from_addr, "to": to, "subject": subject, "text": text}
+    if html:
+        body["html"] = html
+    if reply_to:
+        body["replyTo"] = reply_to
+    return _request("POST", "/api/send", body)
+
+
+def delete_inbox(address: str) -> Dict:
+    """
+    Delete an inbox immediately.
+
+    Args:
+        address: The inbox email address
+
+    Returns:
+        Dict with 'success': True
+    """
+    return _request("DELETE", f"/api/inbox/{urllib.parse.quote(address)}")
+
+
+def get_sent_emails(address: str) -> Dict:
+    """
+    Get sent emails (outbox) for an inbox.
+
+    Args:
+        address: The inbox email address
+
+    Returns:
+        Dict with 'emails' list
+    """
+    return _request("GET", f"/api/inbox/{urllib.parse.quote(address)}/sent")
+
+
+def check_username(username: str, domain: str = "nenzmail.xyz") -> Dict:
+    """
+    Check if a custom username is available.
+
+    Args:
+        username: Desired username (3-30 chars)
+        domain: Domain to check
+
+    Returns:
+        Dict with 'available', 'email', 'error'
+    """
+    qs = f"?domain={urllib.parse.quote(domain)}" if domain else ""
+    return _request("GET", f"/api/inbox/check/{urllib.parse.quote(username)}{qs}")
+
+
+def get_domains() -> Dict:
+    """
+    Get available domains.
+
+    Returns:
+        Dict with 'domains' list and 'default' domain
+    """
+    return _request("GET", "/api/domains")

nenzmail-1.0.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nenzmail"
+version = "1.0.0"
+description = "Free disposable email API client — create temp inboxes, receive emails, and send emails. No auth required."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "NenzMail" }]
+keywords = [
+    "temp-mail", "tempmail", "disposable-email", "throwaway-email",
+    "burner-email", "anonymous-email", "email-api", "send-email",
+    "nenzmail", "temporary-email"
+]
+requires-python = ">=3.8"
+dependencies = []
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Communications :: Email",
+]
+
+[project.urls]
+Homepage = "https://nenzmail.xyz"
+Repository = "https://github.com/AyuTriphasari/nenzmail"
+"Bug Tracker" = "https://github.com/AyuTriphasari/nenzmail/issues"
+
+[tool.setuptools]
+py-modules = ["nenzmail"]

nenzmail-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+