Envelopes快速上手教程：3行代码发送你的第一封Python邮件（含附件）

Envelopes快速上手教程3行代码发送你的第一封Python邮件含附件【免费下载链接】envelopesMailing for human beings项目地址: https://gitcode.com/gh_mirrors/en/envelopesEnvelopes是一个为 Python 开发者打造的邮件发送库口号是 Mailing for human beings为人类写邮件。它对 Python 内置的email和smtplib模块做了人性化封装让你无需手写繁琐的 MIME 结构3 行代码就能发送一封带附件的 Python 邮件。本教程面向新手带你从零开始完成安装、发送第一封邮件、添加附件到本地测试的完整流程。Envelopes 是什么 一个更人性化的 Python 邮件库直接用smtplib发邮件你需要手动构建 MIME 消息、处理编码、拼装附件代码又长又容易出错。Envelopes 把这些细节全部藏起来你只需要关注发给谁、写什么、附什么文件。能力说明 灵活地址格式支持userx.com、Name userx.com、(userx.com, Name)三种写法 正文支持纯文本、HTML 或两者兼有multipart CC / BCC可添加任意数量的抄送与密送 附件一行代码附加任意文件自动识别 MIME 类型 编码地址、正文、标题、附件文件名均支持任意 Python unicode 字符集核心类Envelope定义在 envelopes/envelope.py连接层封装在 envelopes/conn.py。一键安装 Envelopes最快配置方法在终端执行一条 pip 命令即可安装建议先创建虚拟环境pip install Envelopes如果你更想从源码开始可克隆仓库git clone https://gitcode.com/gh_mirrors/en/envelopes cd envelopes pip install -e .安装完成后验证导入是否成功from envelopes import Envelope, GMailSMTP3 行代码发送你的第一封 Python 邮件这是 Envelopes 最经典的用法——创建信封、填好内容、一键发送from envelopes import Envelope envelope Envelope( from_addrfromexample.com, to_addrtoexample.com, subject我的第一封邮件, text_body你好这是一封用 Envelopes 发送的 Python 邮件 ) envelope.send(smtp.example.com, port587, loginfromexample.com, password你的密码或授权码, tlsTrue)参数小贴士envelope.send()的参数会直接传给SMTP构造器常用参数有host、port默认 25、login、password、tls是否启用 STARTTLS、timeout。发 Gmail 邮件时记得用授权码而非登录密码。一行代码加附件Python 邮件带文件的正确姿势发送报表、图片等文件只需一行envelope.add_attachment(/path/to/helicopter.jpg)add_attachment会自动猜测文件的 MIME 类型基于扩展名猜不到时回退为application/octet-stream附件文件名也会自动编码中文文件名同样没问题。想显式指定类型时envelope.add_attachment(/path/to/data.bin, mimetypeapplication/octet-stream)选对邮筒4 种内置 SMTP 连接类型除了临时的envelope.send(...)Envelopes 在 envelopes/conn.py 中内置了多个预配置的连接类一个连接可以复用发送多封邮件性能更好连接类适用场景预配置SMTP任意自定义邮件服务器需指定 host/port/tlsGMailSMTPGmail 邮箱smtp.googlemail.com TLSSendGridSMTPSendGrid 邮件服务smtp.sendgrid.net:587MailcatcherSMTP本地 Mailcatcher 测试localhost:1025复用连接的示例from envelopes import Envelope, GMailSMTP gmail GMailSMTP(fromexample.com, 授权码) for subject in (周报, 月报): env Envelope(from_addrfromexample.com, to_addrbossexample.com, subjectsubject, text_body请查收) gmail.send(env)进阶玩法CC/BCC、HTML 正文与自定义邮件头真实的业务邮件常常需要抄送、富文本和自定义头Envelopes 全部支持envelope Envelope( from_addr(meexample.com, 我), to_addr[aexample.com, bexample.com], # 支持列表 cc_addr[ccexample.com], # 抄送 bcc_addr[bossexample.com], # 密送 subject带富文本的邮件, text_body纯文本版本, html_bodyh1HTML 版本/h1p你好/p, headers{Reply-To: replyexample.com, X-Mailer: Envelopes} )发送后还可以用envelope.to_mime_message()拿到标准的MIMEMultipart对象方便与现有代码集成。本地测试不发真邮件MockSMTP 帮你兜底测试环境最怕误发邮件。lib/testing.py 提供了MockSMTP模拟类配合项目自带的 tests/ 目录可以记录所有 SMTP 调用而不实际联网——写单元测试时替换smtplib.SMTP即可安全地验证你的发信逻辑。常见问题速查清单 ✅Q发送超时或连接失败检查端口25/465/587与tls参数是否匹配你的邮件服务商可加timeout10定位问题。QGmail 提示认证失败需在 Gmail 设置中开启应用专用密码授权码。Q中文附件名乱码不必担心add_attachment会自动对文件名做 RFC 2047 编码。Q想调试邮件原文调用envelope.to_mime_message().as_string()打印完整 MIME 内容。写在最后从安装到发出第一封带附件的 Python 邮件你只需要一条 pip 命令和寥寥几行代码——这就是 Envelopes 为人类写邮件的初心。项目采用 MIT 协议开源核心代码集中在 envelopes/ 目录envelope.py封装邮件、conn.py封装连接、connstack.py管理连接栈示例代码可参考 examples/example_celery.py 与 examples/example_flask.py。上手愉快【免费下载链接】envelopesMailing for human beings项目地址: https://gitcode.com/gh_mirrors/en/envelopes创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考