Metadata-Version: 2.1
Name: 1secMail
Version: 0.5.0
Summary: Create and receive email in only 1 second! 📧 An API wrapper for www.1secmail.com written in Python.
Home-page: https://github.com/qvco/1secMail-Python
Download-URL: https://github.com/qvco/1secMail-Python
Author: qvco
Author-email: nikola.desuga@gmail.com
Maintainer: qvco
Maintainer-email: nikola.desuga@gmail.com
License: MIT
Keywords: 1secmail,onesecmail,tempmail,email,api,wrapper,library
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
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx (>=0.17.1)

  1secMail

An API wrapper for www.1secmail.com (https://www.1secmail.com/) written in Python.

### About

This is a simple Python API wrapper for www.1secmail.com ↗ using the official 1secMail API. It allows you to easily generate temporary email addresses as much as you want and retrieve emails sent to those addresses.

### Install

To install this package, you'll need Python 3.8 or above installed on your computer. From your command line:

```bash
pip install 1secMail
```


> **Note**
> If you're willing to install the development version, do the following:

```bash
git clone https://github.com/qvco/1secMail-Python

cd 1secMail-Python

pip install -r requirements.txt

pip install -e .
```

### How To Use

```python
import secmail

client = secmail.Client()

client.random_email(amount=1)[0]
>>> 'vsd2bq6zo3@1secmail.net'

client.custom_email(username="bobby-bob", domain="kzccv.com")
>>> 'bobby-bob@kzccv.com'


# Checking your mailbox:
messages = client.get_messages("bobby-bob@kzccv.com")
for message in messages:
    print(message.id)
    print(message.from_address)
    print(message.subject)
    print(message.date)


# Fetching single message:
message = client.get_message(address="bobby-bob@kzccv.com", message_id=235200687)
print(message.id)
print(message.subject)
print(message.body)
print(message.text_body)
print(message.html_body)
print(message.attachments)
print(message.date)


# Checking attachment informations
for attachment in message.attachments:
    print(attachment.filename)
    print(attachment.content_type)
    print(attachment.size)
```

### Licnese

This software is licensed under the [MIT](https://github.com/qvco/1secMail-Python/blob/master/LICENSE) © [Qvco](https://github.com/qvco).
