Python接收邮件的几种方式

工作中,我们基本上都用过电子邮件的客户端,比如说 OutLook,Foxmail,从配置项可以知道,SMTP 协议用于发送邮件,POP3 和 IMAP 协议用于接收邮件。其实很多编程语言都有这类协议的实现,Python 自然也不例外,标准库 smtplib、poplib、imaplib 是对应协议的实现。

至于发送邮件,不推荐初学者使用 smtplib,推荐使用 djangomail,具体方法见前文最简单的方式发送邮件,让程序出错自动发邮件

今天分享如何使用 poplib、imaplib 来接收邮件。

你说这两个都可以用来收邮件,到底用哪一个呢? 先看下他们的区别。

POP3 与 IMAP 的区别

POP3 协议是 Post Office Protocol 3 的简称,即邮局协议的第 3 个版本,是 TCP/IP 协议族中的一员,默认端口是110。本协议主要用于支持使用客户端远程管理在服务器上的电子邮件。

IMAP 全称是 Internet Mail Access Protocol,即交互式邮件访问协议,是一个应用层协议,端口是 143。用来从本地邮件客户端访问远程服务器上的邮件。

POP3 工作在传输层,而 IMAP 工作中应用层,从这一点来看,IMAP 更为高级,事实上正是如此。虽然这两个协议都是从邮件服务器下载邮件到本地,但是不同的是 IMAP 提供双向通信,也即在客户端所作的更改会反馈给服务器端,跟服务器端形成同步,例如删除邮件,创建文件夹等。而 POP3 是单向通信的,即下载邮件到本地就算了,所作的更改都只是在客户端,不会反映到服务器端。所以使用 IMAP 协议也会更便捷,体验更好,更可靠。

因此,如果你希望对邮件的更改同步到服务端,那么使用 IMAP,否则使用 POP3

POP3 发送邮件

以下面的代码为例,我们来获取最新的一封邮件内容:

import poplib
from email.parser import Parser
from utils import print_info
import settings


# 连接到POP3服务器:
server = poplib.POP3(settings.pop3_server)
# 身份认证:
server.user(settings.email)
server.pass_(settings.password)

# stat()返回邮件数量和占用空间:
print('Messages: %s. Size: %s' % server.stat())
# list()返回所有邮件的编号:
resp, mails, octets = server.list()
# 可以查看返回的列表类似[b'1 82923', b'2 2184', ...]

# 获取最新一封邮件, 注意索引号从1开始:
latest_mail_index = len(mails)
resp, lines, octets = server.retr(latest_mail_index)

# lines存储了邮件的原始文本的每一行,
# 可以获得整个邮件的原始文本:
msg_content = b'\r\n'.join(lines).decode('utf-8')
# 稍后解析出邮件:
msg = Parser().parsestr(msg_content)
print_info(msg)
# 邮件索引号直接从服务器删除邮件
# server.dele(index)
# 关闭连接:
server.quit()

执行结果如下:

image

poplib 收取邮件分两步:第一步是获取邮件列表,第二步是用 email 模块把原始邮件解析为 Message 对象,然后,用适当的形式把邮件内容展示出来。print_info 函数的逻辑比较复杂,放在了 utils.py 中,完整代码见文末的链接。

基于 poplib 的三方库

使用完标准库 poplib,也使用过三方库 zmail,我只想说,还是三方库用起来爽。

zmail

Zmail 使得在 Python3 中发送和接受邮件变得更简单。你不需要手动添加服务器地址、端口以及适合的协议,zmail 会帮你完成。此外,使用一个字典来代表邮件内容也更符合直觉。

Zmail 仅支持 Python3,不依赖任何三方库。安装方法:

pip install zmail

特性:

  • 自动寻找服务器地址以及端口
  • 自动使用可靠的链接协议
  • 自动将一个python字典映射成MIME对象(带有附件的)
  • 自动添加头文件以及localhostname来避免服务器拒收你的邮件
  • 轻松自定义你的头文件
  • 支持使用HTML作为邮件内容
  • 仅需 python>=3.5,你可以将其嵌入你的项目而无需其他的依赖

示例代码:

import zmail
server = zmail.server('yourmail@example.com', 'yourpassword')

# Send mail
server.send_mail('yourfriend@example.com',{'subject':'Hello!','content_text':'By zmail.'})
# Or to a list of friends.
server.send_mail(['friend1@example.com','friend2@example.com'],{'subject':'Hello!','content_text':'By zmail.'})

# Retrieve mail
latest_mail = server.get_latest()
zmail.show(latest_mail)

可以看出,接收最新的邮件只需要两行代码:

latest_mail = server.get_latest()
zmail.show(latest_mail)

执行结果如下:

image

很简洁,很好用。

文档:https://github.com/zhangyunhao116/zmail/blob/master/README-cn.md

imap 接收邮件

很多主流邮箱如 163,qq 邮箱默认关闭了 imap 的服务,可手动前往邮箱账户设置页面开启,并生成授权码,授权码就是代码中用于登录的密码。

获取最新的邮件并展示:

import imaplib
import email  #导入两个库
import settings
from utils import print_info

M = imaplib.IMAP4_SSL(host = settings.imap_server)
print('已连接服务器')
M.login(settings.email,settings.password)
print('已登陆')
print(M.noop())
M.select()

typ, data = M.search(None, 'ALL')
for num in data[0].split():
    typ, data = M.fetch(num, '(RFC822)')
    # print('Message %s\n%s\n' % (num, data[0][1]))
    # print(data[0][1].decode('utf-8'))
    msg = email.message_from_string(data[0][1].decode('utf-8'))
    print_info(msg)
    break
M.close()
M.logout()

运行结果如下:

image

基于 imaplib 的三方库

你可能会问:为什么要为 Python 创建另一个 IMAP 客户端库?Python 标准库不是已经有 imaplib 了吗?。

imaplib 的问题在于它非常底层。 使用起来相当复杂,你可能需要处理很多细节问题,由于 IMAP 服务器响应可能非常复杂,这意味着使用 imaplib 的每个人最终都会编写自己的脆弱解析程序。

此外,imaplib 没有很好地利用异常。 这意味着您需要检查 imaplib 的每次调用的返回值,以查看请求是否成功。下面推荐两个常用的三方库。

imapclient

imapclient 在内部使用的 imaplib,但比 imaplib 好用的多,示例代码如下:

import ssl
from imapclient import IMAPClient
import settings
# context manager ensures the session is cleaned up


ssl_context = ssl.create_default_context()
# don't check if certificate hostname doesn't match target hostname
ssl_context.check_hostname = False
# don't check if the certificate is trusted by a certificate authority
ssl_context.verify_mode = ssl.CERT_NONE

with IMAPClient(host=settings.imap_server,ssl_context=ssl_context) as client:
    client.login(settings.account,settings.password)
    select_info = client.select_folder('INBOX')
    print('%d messages in INBOX' % select_info[b'EXISTS'])
    # search criteria are passed in a straightforward way
    # (nesting is supported)
    messages = client.search(['FROM', 'xxxx@163.com'])
    # `response` is keyed by message id and contains parsed,
    # converted response items.
    for message_id, data in client.fetch(messages, ['ENVELOPE']).items():
        envelope = data[b'ENVELOPE']
        print('{id}: subject: {subject} date: {date}'.format(
            id=message_id,
            subject = envelope.subject.decode(),
            date = envelope.date
        ))

文档: https://github.com/mjs/imapclient

imap_tools

通过 IMAP 处理电子邮件和邮箱,支持以下功能:

  • 解析的电子邮件消息属性
  • 用于搜索电子邮件的查询生成器
  • 使用电子邮件的操作:复制、删除、标记、移动、看到、追加
  • 使用文件夹的操作:列表、设置、获取、创建、存在、重命名、删除、状态
  • 没有依赖项
pip install imap-tools

示例代码:

from imap_tools import MailBox, AND

# get list of email subjects from INBOX folder
with MailBox('imap.mail.com').login('test@mail.com', 'pwd') as mailbox:
    subjects = [msg.subject for msg in mailbox.fetch()]

# get list of email subjects from INBOX folder - equivalent verbose version
mailbox = MailBox('imap.mail.com')
mailbox.login('test@mail.com', 'pwd', initial_folder='INBOX')  # or mailbox.folder.set instead 3d arg
subjects = [msg.subject for msg in mailbox.fetch(AND(all=True))]
mailbox.logout()

文档:https://github.com/ikvk/imap_tools

最后的话

完整示例代码:https://github.com/somenzz/tutorial/tree/master/email

使用标准库有助于我们加深对邮件协议细节的理解,而三方库却可以不用考虑过多细节,直接上手,标准库相当于手动挡,三方库相当于自动挡,具体用哪个,选择最适合自己的就好。

推荐阅读更多精彩内容