API for composing emails through an external application
Project description
**mailcomposer** aims to provide a simple, cross-platform interface for composing emails through an external application like Microsoft Outlook. Some reasons you might use it are:
* You're behind a corporate firewall, and are only able to send email using Outlook.
* You don't have an SMTP server, or don't want the hassle of using `smtplib`.
* You just prefer your desktop email client.
Here's how easy it is to use:
```python
# This automatically selects an appropriate email application
from mailcomposer import MailComposer
mc = MailComposer()
# Set some message headers
mc.to = "nobody@example.com"
mc.subject = "Testing mailcomposer"
# Set the message body
mc.body = "This is a demonstration of the mailcomposer package."
# Attach this README file
mc.attach_file("README.md")
# Display the message in your email application
mc.display()
```
## Features
Notable features include:
* Straightforward API
* Cross-platform
* Runs on both Python 2 and 3
* Uses your desktop email client; no SMTP server required
* To, CC, and BCC fields accept single recipients or Python lists
* Messages can be composed in either plain-text or HTML format
* Attachments are easy -- just pass the filename
## Supported Email Applications
Supported email applications currently include:
* Microsoft Outlook (Windows only; requires [pywin32](https://pypi.org/project/pywin32/))
* Mozilla Thunderbird
* You're behind a corporate firewall, and are only able to send email using Outlook.
* You don't have an SMTP server, or don't want the hassle of using `smtplib`.
* You just prefer your desktop email client.
Here's how easy it is to use:
```python
# This automatically selects an appropriate email application
from mailcomposer import MailComposer
mc = MailComposer()
# Set some message headers
mc.to = "nobody@example.com"
mc.subject = "Testing mailcomposer"
# Set the message body
mc.body = "This is a demonstration of the mailcomposer package."
# Attach this README file
mc.attach_file("README.md")
# Display the message in your email application
mc.display()
```
## Features
Notable features include:
* Straightforward API
* Cross-platform
* Runs on both Python 2 and 3
* Uses your desktop email client; no SMTP server required
* To, CC, and BCC fields accept single recipients or Python lists
* Messages can be composed in either plain-text or HTML format
* Attachments are easy -- just pass the filename
## Supported Email Applications
Supported email applications currently include:
* Microsoft Outlook (Windows only; requires [pywin32](https://pypi.org/project/pywin32/))
* Mozilla Thunderbird
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mailcomposer-0.1.0.tar.gz
(6.0 kB
view hashes)
Built Distribution
Close
Hashes for mailcomposer-0.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0e0d6ca7cb024899fdaa16fe4cc3b44e204caced524ddc3f190d77c6093f9e97 |
|
MD5 | f7cec3467b8f4e67631e8e5cade0fcf3 |
|
BLAKE2b-256 | 23728138b93dc270caef724f99412051d953361c498fd7258f096b8199e3a9da |