Listen in an email folder and process incoming emails.
Project description
email_listener
email_listener is a Python package for listening in an email folder and processing incoming emails by scraping them, and optionally processing them with a custom processing script. Additionally, the EmailResponder class is included as an easy way to send reply emails.
email_listener currently supports only Gmail, but other email services may work with minor tweaks.
Basic usage:
import email_listener
# Set your email, password, what folder you want to listen to, and where to save attachments
email = "example@gmail.com"
app_password = "password"
folder = "Inbox"
attachment_dir = "/path/to/attachments"
el = email_listener.EmailListener(email, app_password, folder, attachment_dir)
# Log into the IMAP server
el.login()
# Get the emails currently unread in the inbox
messages = el.scrape()
print(messages)
# Start listening to the inbox and timeout after an hour
timeout = 60
el.listen(timeout)
The output:
{'227_somebody@gmail.com': {'Subject': 'EmailListener Test', 'Plain_Text': 'This is the plain text message.\r\nThis is another line.\r\n', 'Plain_HTML': 'This is the HTML message. \nThis is another line. \n\n', 'HTML': '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r\n<html xmlns="http://www.w3.org/1999/xhtml">\r\n <head>\r\n <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r\n <title>EmailListener Test</title>\r\n <meta name="viewport" content="width=device-width, initial-scale=1.0"/>\r\n </head>\r\n <body>\r\n <p>This is the HTML message.<br/>This is another line.<br/></p>\r\n </body>\r\n</html>', 'attachments': ['/home/pi/email_listener/tests/attachments/EmailListener_test.txt']}}
The output, but prettier:
{'227_somebody@gmail.com':
{'Subject': 'EmailListener Test',
'Plain_Text': 'This is the plain text message.\r\nThis is another line.\r\n',
'Plain_HTML': 'This is the HTML message. \nThis is another line. \n\n',
'HTML': '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r\n
<html xmlns="http://www.w3.org/1999/xhtml">\r\n
<head>\r\n
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />\r\n
<title>EmailListener Test</title>\r\n
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>\r\n
</head>\r\n
<body>\r\n
<p>This is the HTML message.<br/>This is another line.<br/></p>\r\n
</body>\r\n
</html>',
'attachments': ['/home/pi/email_listener/tests/attachments/EmailListener_test.txt']
}
}
More detailed examples can be found in each module.
How to Install
email_listener is available on pypi
https://pypi.org/project/email-listener/
$ pip install email_listener
Package Requirements
- IMAP must be enabled in the 'Forwarding and POP/IMAP' section of the Gmail settings.
- A Google Account app password must be created, which can be done in the 'Security' section of your Google Account page.
Running Unit Tests
Once the unit test requirements are met, run the unit tests with the following command:
python3 -m pytest
Unit Test Requirements
Unit tests require a valid gmail account, which requires a few additions:
- A label (or folder) named 'email_listener' must be created
- A filter must be created, which moves any emails sent to '+email_listener@gmail.com' to the email_listener label/folder
Along with these changes, the following environmental variables must be created:
EL_EMAIL and EL_APW
For example, on the Raspian OS, this can be done by adding the following to /home/pi/.profile:
export EL_EMAIL="[Your Gmail email]"
export EL_APW="[Your Google Account app password]"
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file email_listener-1.2.tar.gz.
File metadata
- Download URL: email_listener-1.2.tar.gz
- Upload date:
- Size: 11.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c1871baa078e9fdf400a7baba0d50cc32ca453e1ac4f66658edc392faebeeb42
|
|
| MD5 |
1967cae2d5945121e653b72f26ca32fa
|
|
| BLAKE2b-256 |
7ace1a2af5fc8cbe07fdaab835c2d0ef77f72187f2faebb6b4b179bb0e725956
|
File details
Details for the file email_listener-1.2-py3-none-any.whl.
File metadata
- Download URL: email_listener-1.2-py3-none-any.whl
- Upload date:
- Size: 24.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ed69ac7beaf0cbd1e8eef281c672ea7d5bcd49699962cb1ab2f997fe67dd72c
|
|
| MD5 |
60d611687e0467192dd68264e8cebd44
|
|
| BLAKE2b-256 |
2492ad904144c7a49c9295cf4117b8e498a3e1fdaa768696bec3029a18b6a7bc
|
