【明确项目目标】
学员小贾是一名外贸人员,每到了节假日,要给客户发祝福邮件。
虽然现在群发邮件比较方便,但还是要每次手动添加收件人的邮箱。小贾想:要是能够自动发送邮件给这些人就好了。
除了要学习这个模块相关的知识之外,我认为更重要的仍是掌握【学习模块的方式】,也可以理解为掌握【学习新知识的方式】。
这也是我们的另一个项目目标:学会自学新模块。
【分析过程,拆解项目】
版本1.0,主要是根据需求,自己寻找和学习相关的模块,然后给自己发一封最简单的邮件。
版本2.0呢,还是给自己发邮件,但邮件应该更完整,包括邮件头(就是发件人、邮件标题等),和正文内容。
版本3.0呢,主要是从单一收件人,变成多收件人,也就是群发一封完整的邮件。
【逐步执行,代码实现】
【版本1.0:学习模块,发一封简单邮件】
在编程世界中,我们不需要什么知识都一把抓,而是遇到问题之后,产生了某种需求,才会去找对应的解决方案。
这个方案可能是某个模块,也可能是某个函数~
就像在第一个PK小游戏项目中,我们想:要是能够随机生成某个区间内的数字,替代固定的血量值,可能会好一点。于是我们就学习并引入了random模块。
其实,只要搜索关键词“发送邮件 python”,就能找到解决方案。
搜索后你看到这样的页面,不用逐一点进去看就能知道:1.Python可以解决这个问题;2.方法是smtplib,email这两个模块。
而且还会知道:smtplib是用来发送邮件用的,email是用来构建邮件内容的。这两个都是Python内置模块。
为了方便自己理解,我们可以尝试把它画下来:
负责发送邮件的smtplib模块,和负责构造邮件内容的email模块,就是我们今天要学习的新模块~
一般,提供的关键字越多,搜索引擎返回的结果越精确。我们可以使用+号或者空格连接关键词,也可使用之前学习的and和or来连接,其含义和之前学习的一样,分别表示“并且”和“或者”。
找到解决方案并大致了解模块之后,重头戏来了——学习这两个模块:
昨天我们已经提供了一些学习的渠道,我们以smtplib模块为例来实操一下:
对于smtplib模块,我们想要去查看它的官方文档,也只需要在浏览器里搜索关键词“smtplib python”就好。
你能看到,第1个搜索结果是Python 3.7.2版本的smtplib模块介绍。打开这个网址,你看到满屏的英文:
如果你英文够好,那就可以去阅读;如果你英文不太好,也可以使用谷歌浏览器自带的“谷歌翻译”功能,将页面翻译成中文再阅读。
这个文档提供的内容有:需要向smtplib模块输入什么;smtplib模块能做什么;smtplib模块返回的是什么;常见的报错;SMTP对象有哪些方法及如何使用;一个应用实例。
如果是这么讲,你会发现逻辑还是蛮清晰的。但它依然对新手蛮不友好,读起来比较痛苦。
如果你能够接受这种难度的文档,那么照着这个去写代码是最好不过的,毕竟它是官方文档。但如果你不能接受呢,还有一些方案。
关键词换成 “smtplib 教程” ,你就能看到好多好多中国人编写的内容。在可读性上,是要比官方文档好一些的,但缺点在于良莠不齐。你可以自行挑选适合自己的去阅读。
上一关我们总结了模块三问:函数;属性或方法;格式。今天学习的两个模块比较简单,我们就不一一回答了,我们直接带着两个问题去学。
关于第1个问题,需要你现在点开搜索到的内容看看,你可以看别人的简介;也可以直接看代码,多对比不同人写的代码,那些重复出现的代码可能就是我们要找的方法。
总结一下这些内容,如果我们要发送邮件,就需要用到smtplib模块的以下方法:
第三行,server是一个变量,smtplib.SMTP()是变量server的值。我们已经知道了smtplib是模块的名称,那SMTP是什么意思呢?
请你先在自己电脑的VS Code上新建一个.py文件。注意:这个.py文件不能命名为email.py,而且你存放这个py文件的文件夹里,也不能有email.py同名文件。这是由于我们后面要调用email模块,如果将文件也命名为email,会造成报错。
现在请你把上面的代码复制进去。按住Ctrl键并点击SMTP ,会看到对SMTP的解释:
可以看到,SMTP 是一个类(class),再往下面滑可以看到其中包含了很多函数,第二到第五行的函数就是 SMTP 类下的方法。
要想调用 smtplib 模块下、SMTP 类下的方法,应该这样写:smtplib.SMTP.方法。
我们看到的那段代码,则是为了减少代码冗余,已经将需要重复出现的smtplib.SMTP赋值给了变量,可见,在编程的世界有多讨厌重复了。所以还是采用这种写法吧。
这样我们就能够调用需要的函数了,那这些函数有什么含义,要怎么用呢?继续探索。
其实我们只要知道SMTP是什么就能够明白代码的含义了,现在赶紧去搜索一下 “SMTP” 吧。
对,SMTP (Simple Mail Transfer Protocol)翻译过来是“简单邮件传输协议”的意思,SMTP 协议是由源服务器到目的地服务器传送邮件的一组规则。
可以简单理解为:我们需要通过SMTP指定一个服务器,这样才能把邮件送到另一个服务器。
第四行代码,就是干这个工作的,连接(connect)指定的服务器。
host是指定连接的邮箱服务器,你可以指定服务器的域名。通过搜索“xx邮箱服务器地址”,就可以找到。
port 是“端口”的意思。端口属于计算机网络知识里的内容,你可以自行搜索了解,现在我们只要知道它是一个【整数】即可。
我们需要指定SMTP服务使用的端口号,一般情况下SMTP默认端口号为25。
如果25行不通,你可以通过搜索或者去邮箱设置里面查看端口。比如,如果我打算用自己的企业邮箱来发邮件,登录邮箱后,在【设置-选项-POP和IMAP】里面可以看到这些信息:
包括服务器名称,端口和加密方式。服务器名称是mail.forchange.tech,端口是587。你可以登录自己的邮箱,查看这些信息,接下来跟着我一起写代码。
现在参数确定了,代码写出来应该长这样:
接下来的实操,以QQ邮箱为例来展示操作。我们可以搜索“QQ邮箱 smtp设置”得到host和port这两个参数。
两个参数都有了。SMTP服务器地址是:smtp.qq.com,端口是465或587,那就让我们去写代码吧!
这里有两种写法,一是使用默认端口:25。
二是,尝试搜索到的端口,比如465。这时会有些不同,QQ 邮箱采用的加密方式是SSL,我们需要写成这样:
后面,我们采用的是第二种写法。(大家可以先尝试第一种默认端口,如果不行则需要查找服务器对应的端口。)
提醒!QQ 邮箱一般默认关闭SMTP服务,我们得先去开启它。请打开https://mail.qq.com/,登录你的邮箱。然后点击位于顶部的【设置】按钮,选择【账户设置】,然后下拉到这个位置。
就像上面的一样,把第一项服务打开。需要用密保手机发送短信,完成之后,QQ 邮箱会提供给你一个授权码,授权码的意思是,你可以不用QQ的网页邮箱或者邮箱客户端来登录,而是用邮箱账号+授权码获取邮箱服务器的内容。
如果你打算用QQ邮箱自动发邮件,请保存好这个授权码。在你使用SMTP服务登录邮箱时,要输入这个授权码作为密码登录,而【不是】你的邮箱登录密码。
若在设置和开启SMTP服务的过程中有遇到不可逾越的障碍……比如记不清密保手机,那么欢迎你……换个邮箱试试看。只是要重新查找服务器地址,端口和加密方式。这个过程中,保持耐心~
理解了SMTP的含义,下面几行代码的作用也就好理解了:
第五行代码,login是登录的意思,也就是登录你指定的服务器用的,需要输入两个参数:登录邮箱和授权码。
把两个参数放在最前面。这部分的代码我们也可以写出来了:
一个提醒:由于用户名和授权码属于敏感信息,所以我们在本关不会提供用于输入账号和密码的练习区。也就是说,下面的步骤都需要你在自己的电脑上运行。如果还没有新建py文件的,就现在动动手吧。
另外,为了运行代码的方便,我们暂时就大大咧咧地将授权码放在代码里,不过为了安全起见,更好的做法还是利用input()函数来输入,而不是直接展示哟。
第六行代码sendmail是“发送邮件”的意思,是发送邮件用的,sendmail()方法需要三个参数:发件人,收件人和邮件内容。
这里的发件人from_addr与上面的username是一样的,都是你的登录邮箱,所以只用设置一次。
msg.as_string()是一个字符串类型:as_string()是将发送的信息msg变为字符串类型。
这样写还不完整,因为电脑不知道你要发送的信息msg是什么,我们也没有定义。这就需要用到email 模块,后面会解决的。
最后一行代码,quit是“退出”的意思,就是退出服务器。
现在,我们就学习完smtplib模块的方法了,也能够知道这个模块的具体功能,也就是这些方法怎么用。
现在我们可以把上面写好的代码放在一起,以QQ邮箱为例:
现在我们已经搞定了一半,接下来我们就会开始构建邮件的正文内容,让这个程序能跑起来。
我们就要用到构建邮件内容的email 模块。学习email 模块的过程我就不再展示了,请你自己动手。在这之前,有必要先回顾一下之前学习的渠道,以及学习的方式:带着目的学习。
那我们就直接进行实操阶段啦。email 模块:也就是用来写邮件内容的模块。这个内容可以是纯文本、HTML内容、图片、附件等多种形式。
每种形式对应的导入方式是这样的:
from … import …语句上一关我们已经学习过了。与直接导入整个 smtplib 模块(import smtplib)不同,这里我们只是从模块中导入一个或几个函数的做法。
同样,你可以复制上面的内容到本地的编辑器上,按住 ctrl 点击查看含义。
请你按住ctrl同时点击mime,你会看到一个名为init.py的空文件,这说明 email是其实是一个“包”。
这就要谈到“模块”和“包”的区别了,模块(module)一般是一个文件,而包(package)是一个目录,一个包中可以包含很多个模块,可以说包是“模块打包”组成的。
但为什么看到那个空文件,就能知道email是包呢?这是因为Python中的包都必须默认包含一个init.py的文件。
init.py控制着包的导入行为。假如这个文件为空,那么我们仅仅导入包的话,就什么都做不了。所以直接import email是行不通的。
所以,我们就需要使用from … import …语句,从email包目录下的【某个文件】引入【需要的对象】。比如从email包下的text文件中引入MIMEText方法。中文说起来有点复杂,看代码就懂了:
下面,我们先从【构建纯文本的邮件内容】开始,也就是我们版本1.0的功能:发一封最简单的一句话文本邮件。
通过简单的学习,我们就能发现MIMEText()方法需要输入三个参数:文本内容,文本类型和文本编码。
文本内容,我就写一句最简单的“send by python”吧。
好,现在终于可以把用email构建的正文内容,用smtplib模块发送啦。
我又要提醒你,在开始码这段代码之前,最好再梳理梳理代码结构。这是我建议的结构:
也就是这样:
我们在看别人代码的时候,也可以寻找结构清晰的代码作为参考,这样我们找到有用知识的概率也会提高。
按照这个结构,代码就能够码出来了。这是我的版本,你可以同样在自己的编辑器上写一写。记得准备好 QQ 邮箱和授权码(如果不是QQ邮箱,记得替换端口port参数),收件邮箱就写你自己的邮箱:
你收到邮件了吗?
如果发生报错的话,也没关系。这里我收集了几种典型报错信息:
ValueError: server_hostname cannot be an empty string or start with a leading dot.
看到报错,不要慌,小场面。在学习 Python 的过程当中,我们难免会遇到这种报错,这并非坏事,有报错才有成长。当出现报错的时候,我们去阅读报错,读不懂就去搜索。
直接在网络搜索这个报错信息,我们会得到结论:如果你的Python版本是3.7,很可能发生这种报错。因为Python 3.7修改了ssl.py,导致smtplib.SMTP_SSL也连带产生了问题。
而解决方法也很简单:
加入host参数(邮箱服务器地址后),这个问题应该就迎刃而解了。
如果你用的是QQ以外的其他邮箱,也可能会出现一种报错。比如利用我的企业邮箱的话,就会出现如下报错信息:
smtplib.SMTPException: No suitable authentication method found
搜索后,我们很快就会发现,解决方案是:在登录(login)之前调用starttls()方法就可以了。也就是在代码中加入这样一行:
这些问题基本上都能通过搜索解决。如果你搞不清楚是什么问题的话,试一试将端口参数改一下,使用默认端口25。
经过一番缠斗,现在你应该可以去查收你用 Python 发出的第一封邮件了!
在收件箱,你看到的内容大概是这样的:
但是,现在还不能算是一封完整的邮件,没有发件人信息,没有主题,正文内容太简单......这就是我们接下来要干的事情:
【版本2.0:给自己发一封完整邮件】
我们先来丰富邮件头:
邮件头(header,没错它也叫header)是这一块区域,包括主题、发件人、收件人等信息:
现在你可以直接去搜索别人的代码看看,请打开浏览器搜索“发邮件 python”并浏览查看其他人的代码,看和我们之前写好的代码存在哪些区别。
区别就在于,别人的代码多了这几行:
第一行代码,从email包引入Header()方法。Header()是用来构建邮件头的。
标准邮件需要三个头部信息:From , To 和 Subject ,第三到五行代码就提供了这三个信息。
这里我们可以自定义,比如from发件人邮箱地址,to收件人邮箱地址,主题“python test”。
现在收到邮件就有点不一样了:
除了可以直接用邮箱地址之外,你还可以自定义内容,比如:
接下来,我们要想想怎么丰富邮件内容了。
原本邮件内容是写在这里:
如果你想要写很长的内容,建议先设置一个变量text用来放正文内容。
一般,邮件正文需要换行,不想一大串文字直接显示,我们可以在正文内容前后用''',还记得三引号的用法吧!
之前也提到了,出于保护隐私的目的,我们可以把收发件人,和授权码这些信息用input()变成需要输入的模式。
在版本3.0中,也将在一些地方用到这样的方式去改写代码,让整个程序更有“互动性”。
【版本3.0:群发完整邮件】
只要你搜索一下“Python 群发邮件”,就有海量的信息供你参考。我这里讲三种群发的方式:
一,是将收件人信箱的变量设置成一个可以装多个内容的列表:
需要注意的是,to_addrs变量也将作为参数被传入Header方法中:
直接运行程序的话,这里就会发生错误:AttributeError: 'list' object has no attribute 'decode'。
如果你有查看官方文档的好习惯,那么你会发现这是因为Header接受的第一个参数的数据类型必须要是字符串或者字节,列表不能解码。
也就是说,我们要将to_addrs变成一个字符串,怎么做呢?好像没有学过?其实,我们只需要对这行代码做一个这样的操作:
是否觉得眼熟?在关于文件读写的关卡中,有一个哈利波特的课堂小练习,其中我们简单地提到了join()函数,它的功能是把字符串合并:
join()的用法是str.join(sequence),str代表在这些字符串之中你要用什么字符串来连接,你可以用逗号,空格,下划线等等。要将列表的元素合并,当然我们就直接使用逗号来连接了。
来打印一下转换前后的数据类型,验证一下。
这里有个小细节需要注意:我们将收件人变量名从to_addr改成了复数to_addrs之后,后面用到这个变量的地方,也要进行修改!
第一种方式,我们就讲到这里。
第二种方法是采用询问“是否继续输入邮箱地址”的方式,并用while循环来实现多个收件人的功能。
由于我们要存储输入的内容,供发邮件的时候使用。所以需要定义一个空列表to_addrs,用来存放收件人邮箱地址。输入邮箱地址的时候,地址会被追加写进列表。
因为循环次数不固定,所以我们选择while循环来做。我的这段代码是这样的,加了一个print()函数来确认结果:
除了收件人,我们把发件人和授权码也改成input模式。
接下来是最后一种方法:
用上一关学习的csv模块,将收件人邮箱写入csv文件,在发邮件时读取csv文件。
将邮箱地址写入csv模块的方法是write(),步骤是:1.引入csv模块;2.提供需要写入csv文件的数据,3.建文件并写入。
第一行,引入模块。第四行是等待写入csv文件的数据。
但是我们没有这样的文件,所以还需要新建一个to_addrs.csv文件。我们使用的是with语句新建文件,这样做的好处是:到达语句末尾时,会自动关闭文件,不需要close()。
紧接着,我们定义了一个变量writer进行写入,将刚才的文件变量传进来。
之后就是进行数据写入,写入的方法是writerow()。通过遍历列表data将数据一行行写到了to_addrs.csv文件中。
读取的过程就异曲同工了。利用的是read()方法。步骤是:1.引入csv模块;2.打开csv文件;3.读取需要的数据。
row[1]表示csv文件中第1列的数据。想一想:wufeng和kaxi属于第0列的数据,邮箱地址则属于第1列的数据,所以第1列数据才是我们需要的!
接下来要做的就是把取出来的内容赋值给变量to_addrs,并在发送邮件时使用。先提个醒,注意哪些代码需要在for循环内部缩进。
如果报错(报错是很正常的事情啦),记得排查我们之前说过的几个问题。
虽然读取稍微有点麻烦,但如果我们事先建了这样一个存储邮箱的csv文件,之后就可以一直复用它。从长期来看,还是利大于弊的。
而且在更高级的Python爬虫精进课程里面,我们也同样会用到csv模块,早点熟悉它会更好。
此外,你还可以为这个程序加一段异常处理代码,也就是try...except...语句来帮助你更好地处理你遇到的问题。
在这样与现实生活有关的项目中,往往会出现很多意想不到的障碍,比如能否顺利地拿到邮箱授权码,能否找到可用的端口,又比如偷懒把py文件直接命名为email.py而导致的报错等等。
不过,正因为有太多人经历了这样的障碍,所以当你输入关键词搜索,就会发现这些都是前人走过的路,而他们的踊跃提问或分享,成为了让你走得更快的助推器。
到此,我们就学习完了新的模块,更重要的是,希望你掌握了学习的方法:懂得从需求出发寻找解决方案,也知道应该去哪里学习,并掌握了学习的方式。
希望你在码代码的过程中,逻辑结构越来越清晰,而且不那么害怕报错了,最后总能一步步克服困难。
掌握学习模块的方法的你,已经在事实上完成Python“入门”。你能在互联网上找寻很多有用的东西,帮助自己完成想做的项目。
或许你会产生疑问:用现成的邮件软件不好吗?用别人写好的代码不好吗?为什么一定要自己学习。
这个问题,可以从实用性和前瞻性两个角度来回答。
从实用性上来说,单纯地懂得使用python发邮件并没有什么了不起。但它是一块砖,它能和别的砖组合在一起,构建成摩天大厦。最简单的例子,是我们之后可以利用:爬虫和网络邮件的组合,做出更多有趣的事。
再者,即便是同块砖,反复地使用也能带来巨大的效率提升:如果要给一百人发送一百个内容不同的邮件,你就可以去写一个发邮件的程序,配合一些文件读写和循环的操作,非常短时间地完成它。
从前瞻性的角度来回答,就要讲个故事。
在上个世纪有一位年轻人,也写了类似这样一个发邮件的小程序,就像今天的你一样。
后来,他把这个功能做了好多升级:不能只发邮件啊,还得收邮件,存储邮件,日历提醒系统,订阅系统……最后,他把这些功能打包成一个电子邮件客户端。
因为这个电子邮件客户端太好用,后来这个软件被一家更大的公司收购。这个年轻人,此时已经三十多岁,他也一并加入这家公司,负责这家公司的邮箱业务。
时过境迁,来到2010年,移动互联网时代刚刚拉开帷幕。做久邮箱业务的他,敏锐地感知到:在新的时代,人们使用的通讯方式也会迎来新的变革。而这种新的通讯方式,在许多地方和邮件都有着相通之处……
后来的故事,大家都知道了。他的名字叫做张小龙,他做出来的新产品,名字叫微信。
上面提到的第二家公司是腾讯。他当时所负责的邮箱业务,就是我们这节课程里所使用的 QQ 邮箱。
早期的 QQ 邮箱,运行笨重而缓慢。2006年底,张小龙率领团队用精简、轻便的思路设计新版本。2007年,新版的 QQ 邮箱上线,张小龙带领团队也开发了许多创新应用,将QQ邮箱打造为简洁易用、安全稳定的邮箱。2008年,QQ邮箱在腾讯公司获得“七星级产品奖”,张小龙的团队也获得腾讯的年度创新大奖,受到广大用户的欢迎。直至今天,它在中国依然是使用人数最多的邮箱产品。
上面提到的第一家公司是博大公司,张小龙卖出的产品是foxmail。
而这一切,最开始都是从一行类似于'qqmail.sendmail()'的代码开始的。这和你今天所做的事情,并没有本质区别。再加一些存储功能、收邮件功能……借助一个图形界面的模块,你也能写出一个最原始版本的foxmail。
【课后练习】——自制动态二维码
练习目标:
我们会通过今天的作业,学习一个新的模块:MyQR,制作一个动态二维码。
练习要求:
在昨天的练习里,你已经可以通过自己的学习,完成代码的升级。
所以,今天我们不妨多做些新的尝试。
这次的练习,没有提示,没有准备好的网址。
需求很明确:请你在本地编辑器(如vscode、Pycharm),用 Python 制作一个动态二维码。
所以,请你运用在课堂上看到的提示和知识,去思考,去搜索,去学习,完成今天的练习。
【了解新模块】
请去了解一下,要用什么模块来完成这个需求。
不用担心,这个模块并不难。
这一个步骤你可以给自己制定一个目标:
读懂一个用 Python 制作动态二维码的代码。
【代码实操】
你应该已经知道了这个模块是:MyQR,也能读懂相关的代码。
请你自学相关模块知识后,自行下载一个gif,然后在本地编辑器(如vscode、Pycharm)完成代码吧。
对了,不要忘了先安装myqr模块,Windows终端里运行'pip install myqr',Mac终端运行'pip3 install myqr'
【参考代码】