SMTP对象

SMTP实例有以下方法：

SMTP.set_debuglevel（level）

设置调试输出级别。对于True，值为1或level导致连接的调试消息以及发送到服务器和从服务器接收的所有消息。level导致这些消息被加上时间戳

在版本3.5中更改：添加了debuglevel 2.

SMTP.docmd(cmd, args=””)

向服务器发送命令cmd。可选参数args简单地与命令相连，用空格分隔.

这将返回一个由数字响应代码和实际响应行组成的2元组（多行响应连接成一条长行。）

在正常操作中，没有必要显式调用此方法。它用于实现其他方法，可能对测试privateextensions有用.

如果在等待回复时丢失了与服务器的连接，则SMTPServerDisconnected将被抬起.

SMTP.connect (host=”localhost”, port=0 )

连接到给定端口上的主机。默认设置是连接到标准SMTP端口（25）的localhost。如果主机名以冒号结尾（":"）后跟一个数字，该后缀将被剥离，并将该数字解释为要使用的端口号。如果在实例化期间指定了主机，则构造函数会自动调用此方法。返回服务器在其连接响应中发送的响应代码和消息的a2元组.

SMTP.helo（name=””）

使用HELO。hostname参数默认为本地主机的完全限定域名。服务器返回的消息存储为对象的helo_resp属性.

在正常操作中，没有必要明确地调用这个方法。必要时会被sendmail()隐式调用.

SMTP.ehlo (name=””)

使用EHLO。hostname参数默认为本地主机的完全限定域名。检查ESMTP选项的响应并将其存储以供has_extn()。还设置了几个信息属性：服务器返回的消息存储为ehlo_resp属性，does_esmtp设置为true或false，具体取决于服务器是否支持ESMTP，esmtp_features将是一个字典，其中包含此服务器支持的SMTP服务扩展名及其参数（如果有）.

除非您想使用has_extn()在发送邮件之前，不必明确地调用此方法。它会被sendmail()必要时。

SMTP.ehlo_or_helo_if_needed（）

这个方法叫ehlo()和/或helo()如果有一个不太明显的EHLO或HELO指挥本次会议。它尝试了ESMTP EHLO第一个

SMTPHeloError

服务器没有正确回复HELO问候

SMTP.has_extn（name）

返回True如果name在服务器返回的SMTP服务扩展集中，False除此以外。案件被忽略了

SMTP.verify（address）

使用SMTP VRFY。返回包含代码250和完整 RFC 822 如果用户地址有效，则为地址（包括人名）。否则返回一个400或更大的SMTP错误代码和一个错误字符串.

注意

许多网站禁用SMTP VRFY为了欺骗垃圾邮件发送者.

SMTP.login (user, password, *, initial_response_ok=True）

登录需要验证的SMTP服务器。参数是用于进行身份验证的用户名和密码。如果以前没有EHLO或HELO命令此会话，此方法首先尝试ESMTP EHLO。如果验证成功，此方法将正常返回，或者可能引发以下异常：

SMTPHeloError

服务器没有正确回复HELOgreeting.

SMTPAuthenticationError

服务器不接受用户名/密码组合.

SMTPNotSupportedError

AUTH服务器不支持命令.

SMTPException

没有找到合适的身份验证方法.

如果它们被广告宣传为服务器支持，则smtplib支持的每种身份验证方法都会被尝试。见auth()获取支持的身份验证方法列表。initial_response_ok通过auth().

可选关键字参数initial_response_ok指定支持它的forauthentication方法， RFC 4954 中指定的“初始响应”是否可以与AUTH命令，而不是要求挑战/响应.

版本3.5改变：SMTPNotSupportedError可能会被提升，并且initial_response_ok参数被添加了

SMTP.auth（mechanism, authobject, *, initial_response_ok=True/）

发一个SMTP AUTH命令用于指定的验证mechanism，并通过authobject.

mechanism处理质询响应，指定哪个验证机制用作AUTH命令;auth esmtp_features.

authobject元素中列出的有效值必须是一个可调用的对象，它带有一个可选的单个参数：

data = authobject（challenge = None）

如果可选的关键字参数initial_response_ok为true，则authobject()将首先调用，不带参数。它可以返回 RFC 4954 “初始响应”ASCII str，它将被编码并与AUTH命令如下。如果authobject()不支持初始响应（例如因为它需要一个挑战），它应该在None调用时返回challenge=None。如果initial_response_ok是假的，那么authobject()不会先用None.

如果初始响应检查返回​​None， 或者如果 initial_response_ok是的，authobject()将被调用来处理服务器的challengeresponse;challenge它传递的参数将是bytes。它应该返回ASCII str data，它将被base64编码并发送到服务器.

SMTP class为authobjects提供CRAM-MD5, PLAIN，以及LOGIN机制;它们分别命名为SMTP.auth_cram_md5,SMTP.auth_plain和SMTP.auth_login。它们都要求user实例的password和SMTP属性设置为适当的值.

用户代码通常不需要直接调用auth，而是可以调用login()方法，它将按照列出的顺序依次尝试上述每个机制。auth暴露是为了方便实现身份验证方法而不是（或尚未）直接支持smtplib.

新版本3.5.

SMTP.starttls (keyfile=None, certfile=None, context=None)

将SMTP连接置于TLS（传输层安全性）模式。随后的所有SMTP命令都将加密。然后你应该拨打ehlo()again.

如果keyfile和certfile提供，它们用于创建ssl.SSLContext.

可选context参数是ssl.SSLContext对象;这是使用密钥文件和证书文件的替代方法，如果指定keyfile和certfile应该是None.

如果以前没有EHLO或HELO命令这个会话，这个方法首先尝试ESMTP EHLO.

自版本3.6以后删除：keyfile和certfile不赞成使用context。请用 ssl.SSLContext.load_cert_chain()相反，或者让ssl.create_default_context()为您选择系统的可信任CA证书.

SMTPHeloError

服务器没有正确回复HELOgreeting.

SMTPNotSupportedError

服务器不支持STARTTLS扩展.

RuntimeError

您的Python解释器无法使用SSL / TLS支持.

在版本3.3中更改：context已添加.

在版本3.4中更改：该方法现在支持使用SSLContext.check_hostname和Server Name Indicator进行主机名检查（参见HAS_SNI).

在版本3.5中更改：引发的错误由于缺少STARTTLS支持现在是SMTPNotSupportedError子类而不是基础SMTPException.

SMTP.sendmail（from_addr, to_addrs, msg, mail_options=(), rcpt_options=()）

发送邮件。所需的参数是 RFC 822 from-address字符串， RFC 822 列表到地址字符串（一个简单的字符串将是被视为具有1address的列表）和消息字符串。调用者可以传递一个ESMTP选项列表（例如8bitmime）以在MAIL FROM命令中使用mail_options.ESMTP选项（例如DSN命令））应该与所有RCPT命令一起使用，可以作为rcpt_options传递。（如果需要对不同的收件人使用不同的ESMTPoptions，则必须使用低级方法，如mail(), rcpt()和data()来发送邮件。）

注意

from_addr和to_addrs参数用于构造传输代理使用的messageenvelope。sendmail不会以任何方式修改themessage标题.

msg可以是包含ASCII范围内的字符或字节串的字符串。使用ascii编解码器将字符串编码为字节，并将单独的\r和\n字符转换为\r\n字符。字节串没有被修改.

如果以前没有EHLO或HELO命令这个会话，这个方法首先尝试ESMTP EHLO。如果服务器执行ESMTP，则会将消息大小和指定选项的每个传递给它（如果该选项位于服务器通告的特征集中）。如果EHLO失败，HELO将被尝试并且ESMTP选项被抑制.

如果邮件被至少一个接收者接受，则此方法将正常返回。否则会引发异常。也就是说，如果此方法不会引发异常，那么有人应该收到您的邮件。如果此方法不引发异常，则返回一个字典，每个被拒绝的一个条目都有一个条目。每个条目都包含一个SMTP错误代码元组和服务器发送的随附错误消息.

如果SMTPUTF8包含在mail_options中，服务器支持它，from_addr和to_addrs可能包含非ASCII字符.

此方法可能会引发以下异常：

SMTPRecipientsRefused

所有收件人都被拒绝了。没有人收到邮件。异常对象的recipients属性是一个字典，其中包含有关已注入的收件人的信息（如至少有一个收件人被收到时返回的那个）.

SMTPHeloError

服务器没有正确回复HELO问候

SMTPSenderRefused

服务器不接受from_addr.

SMTPDataError

服务器回复了一个意外的错误代码（除了拒绝接受者）.

SMTPNotSupportedError

SMTPUTF8在mail_options中给出但服务器不支持.

除非另有说明，否则即使在异常情况下连接也会打开.

在版本3.2中更改：msg可能是一个字节串.

在版本3.5中更改：SMTPUTF8支持补充，和SMTPNotSupportedError如果指定了SMTPUTF8但是服务器不支持它可以进行评估.

SMTP.send_message (msg, from_addr=None, to_addrs=None, mail_options=(), rcpt_options=())

这是一个方便的方法来调用sendmail()由email.message.Message宾语。这些论点与sendmail()的含义相同，除了msg是Messageobject.

如果from_addr是None或to_addrs是None, send_message使用从msg在中指定RFC 5322 ：from_addr设置为Sender字段，如果它存在，否则到From领域。to_addrs结合To,Cc的Bcc和msg字段的值（如果有的话）。如果消息中只出现一对Resent-*标题，则忽略常规标题和Resent-*使用标题。如果消息包含多个Resent-*标题集，则会引发ValueError，因为无法明确地检测到最新的Resent-集合headers.

send_message序列化msg使用BytesGenerator和\r\n作为linesep，并调用sendmail()来传输结果消息。无论from_addr和to_addrs, send_message的值如何都不传送任何Bcc或Resent-Bcc可能出现在msg的标题。如果from_addr和to_addrs中的任何地址包含非ASCII字符并且服务器没有通告SMTPUTF8支持，则会引发SMTPNotSupported错误。否则Message用policy的一个克隆进行序列化，utf8属性设置为True，并将SMTPUTF8和BODY=8BITMIME添加到mail_options.

版本3.2中的新功能

//版本3.5：支持国际化地址（SMTPUTF8).

SMTP.quit()

终止SMTP会话并关闭连接。返回SMTP QUIT命令的结果

对应于标准SMTP / ESMTP命令的低级方法HELP,RSET, NOOP, MAIL, RCPT和DATA也支持。通常这些不需要直接调用，因此它们没有在文档中记录。有关详细信息，请参阅模块代码.

SMTP示例

此示例提示用户输入消息信封中所需的地址（“To”和“From”地址）以及要传递的消息。请注意，消息中包含的标题必须包含在输入的消息中;这个例子不对RFC 822 头。特别是，’To’和’From’地址必须明确地包含在邮件头中.

import smtplibdef prompt(prompt):    return input(prompt).strip()fromaddr = prompt("From: ")toaddrs  = prompt("To: ").split()print("Enter message, end with ^D (Unix) or ^Z (Windows):")# Add the From: and To: headers at the start!msg = ("From: %s\r\nTo: %s\r\n\r\n"       % (fromaddr, ", ".join(toaddrs)))while True:    try:        line = input()    except EOFError:        break    if not line:        break    msg = msg + lineprint("Message length is", len(msg))server = smtplib.SMTP("localhost")server.set_debuglevel(1)server.sendmail(fromaddr, toaddrs, msg)server.quit()