使用 GMail 发送电子邮件的简单库(包括后台工作程序和日志记录类)[Python 2/3 支持]
项目描述
gmail
-----
'gmail' 模块为 smtplib/email 模块提供了一个简单的包装器,为使用 GMail SMTP 服务
发送电子邮件提供了一个简单的编程接口。 该模块提供以下类: GMail - GMail SMTP 服务的基本接口 GMailWorker - 异步发送消息的后台工作程序 (使用多处理模块) GMailHandler - 日志框架的 GMail 处理程序 Message - 围绕 email.Message 类的包装,简化 了电子邮件消息对象 的创建如果直接运行,模块还提供了一个 cli 接口来发送电子邮件
(python -mgmail.cli)
基本用法:
>>> gmail = GMail('A.User <user@gmail.com>','password')
>>> msg = Message('Test Message',to='xyz <xyz@xyz.com>',text='Hello')
>>> gmail.send(msg)
注意:您需要设置应用程序专用密码,而
不是使用您的帐户密码 - 请参阅:
https:// support.google.com/mail/?p=InvalidSecondFactor
https://security.google.com/settings/security/apppasswords
Message 类还支持简单地生成 html 电子邮件和
添加附件。
>>> msg = Message('测试消息',to='xyz@xyz.com',text="Hello",
在 Python3 中,消息将默认为 unicode (utf8) 编码,除非
文本被传递一个字节对象(在 Python 2 中反之亦然)
有关使用示例,请参见 cli.py 和 test_gmail.py/test_message.py
更改日志:
* 0.1 2012 -10-17 初始版本
* 0.2 2012-10-18 重组模块
* 0.3 2012-12-28 修复日志记录/工作者
* 0.3.1 2012-12-28 CLI 附件 mime 类型修复
* 0.4 2013-08-24 允许用户通过传递 'sender' 指定 'From' 和 'Reply-To' 标头
(从 https://github.com/Kami 提取 - 谢谢)
* 0.5 2014-02-12 将 _gmail_worker 移动到模块函数以修复
win32 上的多处理器问题
(从 gabriel.nevarez@gmail.com 修复 - 谢谢)
* 0.6.1 2016-09-25 Python 3 支持
* 0.6.2 2016-12-12 修复 Python 3 异常处理
* 0.6.3 2017- 08-07 尝试处理非 ascii 文件名
修复 `__del__` 方法调用的异常
(感谢 https://github.com/theonewolf 的修复/拉取请求)
许可证:
* BSD
作者:
* Paul Chakravarti (paul.chakravarti @gmail.com)