dros1986 / emailclient

Email Client for reading and sending emails.

Usage

This library is really easy to use:

from supermail import EmailClient

# define email client
gmail = EmailClient("[email protected]", "your_password")

# get all messages
messages = gmail.read() # if you need only unread, set parameter filter=['UNSEEN']

# for each message
for msg in messages:
	# get message info
	print(msg.subject())
	print(msg.message())
	print(msg.sender())
	# get attachments
	attachments = msg.attachments('./temp') # returns a list of filenames saved in specified dir

# send a message with attachments
gmail.send('[email protected]', 'Nice subject', 'Nice message', \
	cc='[email protected]',
	attachments=['/path/to/pdf.pdf', '/path/to/image.png'])

Note

In order to use GMail, you need to log into your security page and:

1. enable two-step verification
2. right below, it will appear an option called App Password. Create a new one that you will be able to use with supermail.

Other email? No problem!

You can specify custom imap and smtp addresses and ports:

email_address = "[email protected]"
email_pwd = "your_password"
imap_server = "imap.gmail.com"
imap_port   = 993
smtp_server='smtp.gmail.com'
smtp_port=587

# define email client
gmail = EmailClient(email_address, email_pwd, imap_server, imap_port, smtp_server, smtp_port)

Install

You can install supermail from PyPI:

pip install supermail

or from the github page:

pip install git+https://github.com/dros1986/EmailClient.git

emailclient's Issues

Cannot grab x number of emails

Hi! Less of an issue, more a suggestion. I feel it would be a great addition to make some way to pull only a certain number of emails from the inbox, as opposed to all of them. When your inbox is full, it takes quite a while for it to gather all the content.

As a solution, I feel it would be best to make gmail.read() iterable. e.g. gmail.read()[2] would get you the latest 2 emails in your inbox, and so on.

If there is a way to do this, then ignore me or add it to the documentation (I've put pushes on my feed). Overall though, very useful package; 10/10 👍 :)