Metadata-Version: 2.4
Name: mailtm-client-wrapper
Version: 0.1.0
Summary: A robust Python client for the MailTM API
Author-email: YourName <your.email@example.com>
Project-URL: Homepage, https://github.com/yourusername/mailtm-client
Project-URL: Bug Tracker, https://github.com/yourusername/mailtm-client/issues
Keywords: mailtm,disposable-email,api-client,automation
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: build>=1.5.0
Requires-Dist: requests>=2.28.0
Dynamic: license-file

# MailTM Client

A lightweight, robust, and easy-to-use Python client for the [MailTM API](https://docs.mail.tm/). This library is designed for automation tasks that require disposable email addresses and OTP verification.

## Features

- **Simple Interface**: Minimalistic API for rapid integration into your scripts.
- **Automated Setup**: Handles domain fetching, account creation, and authentication in a single workflow.
    - Generate random credentials (email & password).
    - Create accounts automatically.
    - Handle JWT token management.
- **Inbox Management**: Easily fetch the inbox list and read full message contents.
- **Lightweight**: Built on top of `requests` with zero heavy dependencies.

## Installation

You can install it via pip (once published):

```bash
pip install mailtm-client
```

Or directly from GitHub:

```bash
pip install git+https://github.com/yourusername/mailtm-client.git
```

## Quick Start

```python
from mailtm_client import MailTMClient

# 1. Initialize client
client = MailTMClient()

# 2. Generate random credentials and create account
email, password = client.generate_random_credentials()
client.create_account(email, password)

# 3. Login to get the JWT token
token = client.login(email, password)
print(f"Successfully logged in with: {email}")

# 4. Check inbox for messages
messages = client.read_inbox()
for msg in messages:
    print(f"New Message Subject: {msg['subject']}")
```

## License

This project is licensed under the MIT License.
