Command-line SMTP email sending tool in Python
Project description
littlemail
Littlemail is a straight-forward command-line SMTP email sending tool in Python, which sends one email per command. (If you send many emails, every sending will make a new connection with the smtp server.)
Installation
$ pip install littlemail
Usage
There is no way to reduce parameters provided in command-line, since that's the way of email. So, please refer to the inline help for options you need. Fortunately, many options have default value.
$ python -m littlemail -h # inline help
Anyway, here is a minimal example and a few lines of explanation:
$ python -m littlemail -s test [-c hello] \
-f 12345@qq.com \
--to 54321@qq.com \
--smtp smtp.qq.com [-p abcdefg]
-c
means the email content, which is optional. That means you can
send empty-content email. And this optional parameter enables the
capability of littlemail to get content from pipe (input
redirection), which might be easier for you to construct your message,
such as:
$ python -m littlemail <...> < my_email_content.txt
-s
represents subject, which is mandatory and cannot be empty.
-p
stands for password, and it is optional. When it's missing,
littlemail tries to get password from LITTLEMAIL_PASSWD
environment variable.
When something goes wrong, try --debug
.
API
There is an API you can invoke to send email in your code:
# import
from littlemail import send_email
# signature
send_email(subject: str,
*,
text: str = '',
contype: str = 'plain',
alist: list[str] = [],
to: list[str],
cc: list[str] = [],
bcc: list[str] = [],
fromaddr: str,
smtp: str,
port: int = 587,
timeout: int = 3,
protocol: str = 'tls',
passwd: str|None,
debug: bool = False) -> None
api_test.py
is used as an example and testcase for you try, have fun! ^___^
Project details
Release history Release notifications | RSS feed
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
Hashes for littlemail-0.32-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 784eaafe92ec20f0b8cc9310824f31542f099dbba391ab9c4d8030b4c623e870 |
|
MD5 | a28254d2d1ed30911e66022ef265e253 |
|
BLAKE2b-256 | c7019200bec6c744273b31e115aa1cc6b187aa8cc7a0432e92119999df257503 |