Django 2.2 版本发行说明Link to this heading#

约束Link to this heading#

新的 CheckConstraint 和 UniqueConstraint 类允许添加自定义数据库约束。约束可以使用 Meta.constraints 选项添加到模型中。

次要特性Link to this heading#

数据库后端 APILink to this heading#

本节介绍了第三方数据库后端可能需要的更改。

• 第三方数据库后端必须实现对表检查约束的支持，或将 DatabaseFeatures.supports_table_check_constraints 设置为 False。

• 第三方数据库后端必须实现在插入时忽略约束或唯一性错误的支持，或将 DatabaseFeatures.supports_ignore_conflicts 设置为 False。

• 第三方数据库后端必须实现对 DurationField 的内省，或将 DatabaseFeatures.can_introspect_duration_field 设置为 False。

• DatabaseFeatures.uses_savepoints 现在默认为 True。

• 第三方数据库后端必须实现对部分索引的支持，或将 DatabaseFeatures.supports_partial_indexes 设置为 False。

• 移除了 DatabaseIntrospection.table_name_converter() 和 column_name_converter()。第三方数据库后端可能需要代替实现 DatabaseIntrospection.identifier_converter()。在这种情况下，DatabaseIntrospection.get_constraints() 返回的约束名称必须通过 identifier_converter() 进行规范化。

• 索引的 SQL 生成从 Index 移动到 SchemaEditor，并添加了以下 SchemaEditor 方法：

  • _create_primary_key_sql() 和 _delete_primary_key_sql()

  • _delete_index_sql() （与 _create_index_sql() 配对使用）

  • _delete_unique_sql （与 _create_unique_sql() 配对使用）

  • _delete_fk_sql() （与 _create_fk_sql() 配对使用）

  • _create_check_sql() 和 _delete_check_sql()

• 移除了 DatabaseWrapper.__init__() 的第三个参数 allow_thread_sharing。

不再从基本的 ModelAdmin 类中收集管理操作Link to this heading#

例如，在较旧版本的 Django 中：

from django.contrib import admin


class BaseAdmin(admin.ModelAdmin):
    actions = ["a"]


class SubAdmin(BaseAdmin):
    actions = ["b"]

SubAdmin 将具有操作 'a' 和 'b'。

现在，actions 遵循标准的 Python 继承。要获得与以前相同的结果：

class SubAdmin(BaseAdmin):
    actions = BaseAdmin.actions + ["b"]

django.contrib.gisLink to this heading#

• 支持 GDAL 1.9 和 1.10 的功能已被移除。

TransactionTestCase 序列化数据加载Link to this heading#

现在，在 TransactionTestCase 的测试结束后，即在数据库刷新之后加载初始数据迁移。在旧版本中，这些数据在测试开始时加载，但这会阻止 test --keepdb 选项正常工作（整个测试套件结束后数据库为空）。除非您已自定义了 TransactionTestCase 的内部，否则这个变化不应影响您的测试。

sqlparse 是必需的依赖项Link to this heading#

为了简化 Django 数据库处理的几个部分，现在 sqlparse 0.2.2+ 是一个必需的依赖项。它会随着 Django 自动安装。

cached_property 别名Link to this heading#

在以下用法中：

from django.utils.functional import cached_property


class A:
    @cached_property
    def base(self):
        return ...

    alias = base

alias 不会被缓存。在可以检测到问题的情况下（Python 3.6 及更高版本），此类用法现在会引发 TypeError: Cannot assign the same cached_property to two different names ('base' and 'alias')。

请改用以下方式：

import operator


class A:
    ...

    alias = property(operator.attrgetter("base"))

代理模型的权限Link to this heading#

代理模型的权限 现在使用代理模型的内容类型而不是具体模型的内容类型来创建。在运行 migrate 时，迁移将更新现有的权限。

在管理界面中，对于与其具体模型具有相同的 app_label 的代理模型，这个变化是透明的。然而，在旧版本中，对于具体模型具有不同 app_label 的代理模型的权限的用户不能访问管理中的模型。现在这个问题已经修复，但在升级之前，您可能希望审查这些代理模型的权限分配（[add|view|change|delete]_myproxy），以确保新的访问是合适的。

最后，代理模型的权限字符串必须更新以使用它们自己的 app_label。例如，对于继承自 other_app.ConcreteModel 的 app.MyProxyModel，请将 user.has_perm('other_app.add_myproxymodel') 更新为 user.has_perm('app.add_myproxymodel')。

合并表单 Media 资源Link to this heading#

现在，表单 Media 资源使用拓扑排序算法进行合并，因为旧的成对合并算法对某些情况不足够。不包含其依赖项的 CSS 和 JavaScript 文件现在可能会被错误地排序（而旧算法恰好由于巧合而产生了正确的结果）。

请审查所有的 Media 类以查找任何缺失的依赖项。例如，依赖于 django.jQuery 的小部件在 声明表单媒体资源 时必须指定 js=['admin/js/jquery.init.js', ...]。

杂项Link to this heading#

• 为了提高可读性，UUIDField 表单字段现在会显示带有破折号的值，例如 550e8400-e29b-41d4-a716-446655440000，而不是 550e8400e29b41d4a716446655440000。

• 在 SQLite 上，PositiveIntegerField 和 PositiveSmallIntegerField 现在包含一个检查约束，以防止在数据库中出现负值。如果您有现有的无效数据并运行重新创建表的迁移，您将看到 CHECK constraint failed。

• 为了与 WSGI 服务器保持一致，测试客户端现在将 Content-Length 头设置为字符串而不是整数。

• django.utils.text.slugify() 的返回值不再标记为 HTML 安全。

• urlizetrunc、truncatechars、truncatechars_html、truncatewords 和 truncatewords_html 模板过滤器使用的默认截断字符现在是真正的省略号字符（…）而不是 3 个点。您可能需要调整一些测试输出的比较。

• 不再支持在模板文件系统加载器中使用字节串路径。

• django.utils.http.urlsafe_base64_encode() 现在返回一个字符串而不是字节字符串，并且 django.utils.http.urlsafe_base64_decode() 可能不再接受字节字符串作为参数。

• 不再支持 cx_Oracle 版本低于 6.0。

• mysqlclient 的最低支持版本从 1.3.7 增加到 1.3.13。

• SQLite 的最低支持版本从 3.7.15 提高到 3.8.3 。

• 为了提供更语义化的查询数据，NullBooleanSelect 现在呈现 <option> 的值为 unknown、true 和 false，而不是 1、2 和 3。为了向后兼容，旧值仍然被接受为数据。

• Group.name 的 max_length 从 80 增加到 150 个字符。

• 现在在运行于 SQLite 3.20+ 上的测试中，违反可延迟数据库约束的行为将报错，就像其他支持此类约束的后端一样。

• 为了捕获使用错误，测试 Client 和 django.utils.http.urlencode() 现在如果传递 None 作为要编码的值会引发 TypeError，因为 None 不能编码为 GET 和 POST 数据。要么传递空字符串，要么省略值。

• 现在，ping_google 管理命令默认使用 https 而不是 http 作为站点地图的 URL。如果你的站点使用 http，请使用新的 ping_google --sitemap-uses-http 选项。如果你使用 django.contrib.sitemaps.ping_google 函数，请将新的 sitemap_uses_https 参数设置为 False。

• runserver 不再支持 pyinotify （已被 Watchman 替代）。

• 当输入是 Decimal 时， Avg、StdDev 和 Variance 聚合函数现在返回 Decimal 而不是 float。

• 如果没有迁移的应用与具有迁移的应用有关系，那么在 SQLite 上的测试将失败。这自从 Django 1.7 添加迁移以来一直是一个已记录的限制，但现在它失败得更可靠。您将看到类似于 no such table: <app_label>_<model> 的错误导致测试失败。这在一些具有测试中没有迁移的模型的第三方应用中观察到。您必须为这些模型添加迁移。

• 在 cache.delete() 或 cache.get() 的 key 参数中提供整数现在会引发 ValueError。

• 由于已纳入 Transifex 的最新版本，某些语言的复数规则方程式已被更改。

模型的 Meta.ordering 将不再影响 GROUP BY 查询。Link to this heading#

模型的 Meta.ordering 影响 GROUP BY 查询（例如 .annotate().values()）是常见的引发混淆的原因。现在，这种查询会发出一个弃用警告，建议添加一个 order_by() 以保留当前查询。从 Django 3.1 开始，在这种查询中将忽略 Meta.ordering。

杂项Link to this heading#

• django.utils.timezone.FixedOffset 已被弃用，建议使用 datetime.timezone。

• 未记录的 QuerySetPaginator 别名 django.core.paginator.Paginator 已被弃用。

• django.contrib.postgres 中的 FloatRangeField 模型和表单字段已被弃用，推荐使用新名称 DecimalRangeField，以匹配数据库中使用的 numrange 数据类型。

• FILE_CHARSET 设置已被弃用。从 Django 3.1 开始，从磁盘读取的文件必须是 UTF-8 编码的。

• django.contrib.staticfiles.storage.CachedStaticFilesStorage 已被弃用，因为它存在无法解决的问题。请改用 ManifestStaticFilesStorage 或第三方云存储。

• 现在，RemoteUserBackend.configure_user() 方法的第一个位置参数是 request，如果该方法接受它的话。不支持不接受 request 参数的覆盖方法，将在 Django 3.1 中移除。

• SimpleTestCase.allow_database_queries、TransactionTestCase.multi_db 和 TestCase.multi_db 属性已被弃用，推荐使用 SimpleTestCase.databases、TransactionTestCase.databases 和 TestCase.databases。这些新属性允许声明数据库依赖关系，以防止非默认数据库的意外查询在测试之间泄漏状态。以前的行为可以通过设置 databases='__all__' 来实现，即 allow_database_queries=True 和 multi_db=True。