dj-email-url 1.0.6

SMTP后端

当URL中的方案是以下之一时，将选择SMTP后端：

版本0.1中的更改：现在不建议使用smtps。值smtps曾被用来表示使用TLS连接，即设置EMAIL_USE_TLS为True。现在建议使用submission或submit（见IANA的服务名称和端口号或IANA的统一资源标识符方案）。

在最受欢迎的邮件配置选项中，是使用第三方SMTP服务器转发邮件。

>>> url = 'submission://user@example.com:pass@smtp.example.com'
>>> url = dj_email_url.parse(url)
>>> assert url['EMAIL_PORT'] == 587
>>> assert url['EMAIL_USE_SSL'] is False
>>> assert url['EMAIL_USE_TLS'] is True

其他常见选项是使用本地邮件传输代理Postfix或Exim。在这种情况下，操作非常简单

>>> url = 'smtp://'
>>> url = dj_email_url.parse(url)
>>> assert url['EMAIL_HOST'] == 'localhost'
>>> assert url['EMAIL_PORT'] == 25
>>> assert url['EMAIL_USE_SSL'] is False
>>> assert url['EMAIL_USE_TLS'] is False

也可以配置通过SSL的SMTP（通常在465上）。此配置通常不推荐，但对于旧系统可能需要。要应用此配置，请使用查询参数指定SSL（使用ssl=True），并明确指定端口

>>> url = 'smtp://user@domain.com:pass@smtp.example.com:465/?ssl=True'
>>> url = dj_email_url.parse(url)
>>> assert url['EMAIL_PORT'] == 465
>>> assert url['EMAIL_USE_SSL'] is True
>>> assert url['EMAIL_USE_TLS'] is False

文件后端

文件后端是需要路径的唯一后端。URL路径存储在EMAIL_FILE_PATH键中。

未发布

1.0.6 - 2022-09-24

• 删除不必要的代码（感谢@matthiask）。

• 改进许可证元数据。许可证本身没有变化。

1.0.5 - 2022-02-05

• 增加了对超时设置的支持。

1.0.4 - 2022-01-16

• 发布版本后更新变更日志。

1.0.3 - 2022-01-16

• 增加了对Python 3.10的支持。

• 将持续集成基础设施从Travis切换到GitHub Actions。

• 切换到PyPA构建前端。

1.0.2 - 2021-01-23

• 增加对Python 3.9的支持（@pauloxnet）

1.0.1 - 2020-06-03

• 包含LICENSE文件在tar包中。感谢@fabaff。

1.0.0 - 2020-02-16

• 删除了对已达到生命周期的Python版本的支持。

• 修复了拼写错误。感谢@jeffmacdonald。

0.2.0 - 2019-04-08

• 增加了对URL中的DEFAULT_FROM_EMAIL和SERVER_EMAIL作为查询参数的支持。

0.1.0 - 2018-03-24

• 添加了新的方案 submission 和 submit，以便在端口 587 上选择带有 STARTTLS 的 SMTP 后端。感谢 @LEW21 提议包含新的 submit URI。

• 不鼓励使用方案 smtps 并添加用户警告。感谢 @LEW21 提醒这种令人困惑的使用方式。

• 扩展了被视为真值的查询字符串参数的值。现在，1、on、true 和 yes，无论是单个字符还是全部大小写变体（小写、大写和标题大小写）都被视为 True。

0.0.10 - 2016-10-14

• 发布版本后修复了更改日志中的发布日期。

0.0.9 - 2016-10-14

• 修复了当用户在其 URL 中设置 ssl=False 时的错误（感谢 bogdal）。

0.0.8 - 2016-06-07

• 允许使用通用 wheel。

0.0.7 - 2016-05-31

• 在文档中添加 EMAIL_USE_SSL 设置并设置默认值（感谢 iraycd）。

• 添加覆盖率（感谢 iraycd）。

0.0.6 - 2016-04-18

• 修复了解析不带凭据的 URL 时的错误（感谢 martinmaillard）。

0.0.5 - 2016-04-17

• 允许使用 URL 编码的凭据（感谢 kane-c）。

0.0.4 - 2015-03-05

• 修复 README。

0.0.3 - 2015-03-05

• 添加更改日志。

• 为 SMTP 后端添加 ssl= 选项作为查询参数。

• 添加 Travis 持续集成。

0.0.2 - 2014-03-12

• 添加 Python 3 支持。

0.0.1 - 2013-02-12

• 初始版本。