Python标准库smtpdSMTP服务器

新建一个 SMTPServer 对象，它会绑定到本机地址 localaddr。 它将把 remoteaddr 当作上游 SMTP 中继器。 localaddr 和 remoteaddr 都应当是 (host, port) 元组。 该对象继承自 asyncore.dispatcher，因而会在实例化时将自己插入到 asyncore 的事件循环。

data_size_limit 指定将在 DATA 命令中被接受的最大字节数。 值为 None 或 0 表示无限制。

map 是用于连接的套接字映射（初始为空的字典是适当的值）。 如果未指定则会使用 asyncore 全局套接字映射。

enable_SMTPUTF8 决定是否应当启用 SMTPUTF8 扩展（如 RFC 6531 所定义的。 默认值为 False。 当设为 True 时，会接受 SMTPUTF8 作为 MAIL 命令的形参并在被提供时将其传给 kwargs['mail_options'] 列表中的 process_message()。 decode_data 和 enable_SMTPUTF8 不可同时被设为 True。

decode_data 指明 SMTP 事务的数据部分是否应当使用 UTF-8 来解码。 当 decode_data 为 False 时（默认值），服务器会声明 8BITMIME 扩展 (RFC 6152)，接受来自 MAIL 命令的 BODY=8BITMIME 形参，并在该形参存在时将其传给 kwargs['mail_options'] 列表中的 process_message() 方法。 decode_data 和 enable_SMTPUTF8 不可同时被设为 True。

process_message(peer, mailfrom, rcpttos, data, **kwargs)¶

引发 NotImplementedError 异常。 请在子类中重载此方法以实际运用此消息。 在构造器中作为 remoteaddr 传入的任何东西都可以 _remoteaddr 属性的形式来访问。 peer 是远程主机的地址，mailfrom 是封包的发送方，rcpttos 是封包的接收方而 data 是包含电子邮件内容的字符串（应该为 RFC 5321 格式）。

如果构造器关键字参数 decode_data 被设为 True，则 data 参数将为 Unicode 字符串。 如果被设为 False，则将为字节串对象。

kwargs 是包含附加信息的字典。 如果给出 decode_data=True 作为初始参数则该字典为空，否则它会包含以下的键:

mail_options:

由 MAIL 命令所接收的所有参数组成的列表 (其元素为大写形式的字符串；例如: ['BODY=8BITMIME','SMTPUTF8'])。

rcpt_options:

与 mail_options 类似但是针对 RCPT 命令。 目前不支持任何 RCPTTO 选项，因此其值将总是为空列表。

process_message 的实现应当使用 **kwargs 签名来接收任意关键字参数，因为未来的增强特性可能会向 kwargs 字典添加新键。

返回 None 以请求一个正常的 250Ok 响应；在其他情况下则以 RFC 5321 格式返回所需的响应字符串。

channel_class¶

重载这个子类以使用自定义的 SMTPChannel 来管理 SMTP 客户端。

创建一个新的调试服务器。 参数是针对每个 SMTPServer。 消息将被丢弃，并在 stdout 上打印出来。

创建一个新的纯代理服务器。 参数是针对每个 SMTPServer。 一切都将被转发到 remoteaddr。 请注意运行此对象有很大的机会令你成为一个开放的中继站，所以需要小心。

创建一个新的纯代理服务器。 参数是针对每个 SMTPServer。 一切都将被转发到 remoteaddr，除非本地 mailman 配置知道另一个地址，在那种情况下它将由 mailman 来处理。 请注意运行此对象有很大的机会令你成为一个开放的中继站，所以需要小心。

创建一个新的 SMTPChannel 对象，该对象会管理服务器和单个 SMTP 客户端之间的通信。

conn 和 addr 是针对下述的每个实例变量。

data_size_limit 指定将在 DATA 命令中被接受的最大字节数。 值为 None 或 0 表示无限制。

enable_SMTPUTF8 确定 SMTPUTF8 扩展 (如 RFC 6531 所定义的) 是否应当被启用。 默认值为 False。 decode_data 和 enable_SMTPUTF8 不能被同时设为 True。

可以在 map 中指定一个字典以避免使用全局套接字映射。

decode_data 指明 SMTP 事务的数据部分是否应当使用 UTF-8 来解码。 默认值为 False。 decode_data 和 enable_SMTPUTF8 不能被同时设为 True。

要使用自定义的 SMTPChannel 实现你必须重载你的 SMTPServer 的 SMTPServer.channel_class。

SMTPChannel 具有下列实例变量:

smtp_server¶

存放生成此通道的 SMTPServer。

conn¶

存放连接到客户端的套接字对象。

addr¶

存放客户端的地址，socket.accept 所返回的第二个值。

received_lines¶

存放从客户端接收的行字符串列表 (使用 UTF-8 解码)。 所有行的 "\r\n" 行结束符都会被转写为 "\n"。

smtp_state¶

存放通道的当前状态。 其初始值将为 COMMAND 而在客户端发送 "DATA" 行后将为 DATA。

seen_greeting¶

存放包含客户端在其 "HELO" 中发送的问候信息的字符串。

mailfrom¶

存放包含客户端在 "MAIL FROM:" 中标识的地址的字符串。

rcpttos¶

存放包含客户端在 "RCPT TO:" 行中标识的地址的字符串。

received_data¶

存放客户端在 DATA 状态期间发送的所有数据的字符串，直至但不包括末尾的 "\r\n.\r\n"。

fqdn¶

存放由 socket.getfqdn() 所返回的服务器完整限定域名。

peer¶

存放由 conn.getpeername() 所返回的客户端对等方名称，其中 conn 为 conn。

SMTPChannel 在接收到来自客户端的命令行时会通过发起调用名为 smtp_<command> 的方法来进行操作。 在基类 SMTPChannel 中具有用于处理下列命令（并对他们作出适当反应）的方法: