1secMail 1.0.0

Create and receive email in only 1 second! 📧 An API wrapper for www.1secmail.com written in Python.

An API wrapper for www.1secmail.com written in Python.

About

This is an easy to use yet full-featured Python API wrapper for www.1secmail.com ↗ using the official 1secMail API. It allows you to easily create temporary email addresses for testing, verification, or other purposes where you need a disposable email address.

Install

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

pip install 1secMail

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

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

cd 1secMail-Python

pip install -r requirements.txt

pip install -e .

Usage

Generating Email Addresses

To generate a list of random email addresses, use the random_email() method:

import secmail

client = secmail.Client()

client.random_email(amount=3)
>>> ['[e-mail]', '[e-mail]', '[e-mail]']

You can also generate a custom email address by specifying the username and domain:

Note Specifying a domain is optional!

client.custom_email(username="bobby-bob", domain="kzccv.com")
>>> '[e-mail]'

Receiving Messages

To wait until a new message is received, use the await_new_message() method:

message = client.await_new_message(address)

To check all messages received on a particular email address, use the get_inbox() method and pass the email address:

messages = client.get_inbox("[e-mail]")
for message in messages:
    print(message.id)
    print(message.from_address)
    print(message.subject)
    print(message.date)

You can also fetch a single message using the get_message() method and passing the email address and message ID:

message = client.get_message(address="[e-mail]", 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)

Attachment Information

To check attachment information, loop through the attachments in the message object and print the filename, content type, and size:

for attachment in message.attachments:
    print(attachment.filename)
    print(attachment.content_type)
    print(attachment.size)

Licnese

This software is licensed under the MIT © Qvco.