Release Notes

最新推荐文章于 2026-03-07 00:55:17 发布

翻译最新推荐文章于 2026-03-07 00:55:17 发布 · 6.9k 阅读

标签

#Django REST framework

Django REST framework 中文翻译(全) 同时被 2 个专栏收录

58 篇文章

订阅专栏

Django

9 篇文章

订阅专栏

此发布说明概述了REST框架的不同版本的更改，包括功能改进、弃用策略、升级指南和兼容性注意事项。涵盖版本控制策略、次要和主要版本的更改，以及与Django框架的兼容性。

Python3.8

Python 是一种高级、解释型、通用的编程语言，以其简洁易读的语法而闻名，适用于广泛的应用，包括Web开发、数据分析、人工智能和自动化脚本

发行说明 (Release Notes)

尽早发布，经常发布 — Eric S. Raymond, The Cathedral and the Bazaar

版本 (Versioning)

次要版本号 (0.0.x) 用于 API 兼容的更改。您应该能够在小点版本之间进行升级，而无需更改任何其他代码。

中等版本号 (0.x.0) 可能包含 API 更改，这与弃用策略一致。在中点版本之间进行升级之前，您应该仔细阅读发布说明。

主要版本号 (x.0.0) 保留给重要的项目里程碑。

弃用策略 (Deprecation policy)

REST framework 发布遵循正式的弃用策略，这与 Django 的弃用策略一致。

1.0 版本中出现的功能的弃用时间表如下：

版本 1.1 将保持与 1.0 完全向后兼容，但如果您使用将被弃用的功能，则会引发 PendingDeprecationWarning 警告。默认情况下，这些警告是静默的，但是当您准备开始迁移任何所需的更改时，可以显式启用这些警告。例如，如果您使用 python -Wd manage.py test 开始运行测试，则您将收到有关您需要进行的任何API更改的警告。
版本 1.2 会将这些警告升级为 DeprecationWarning，默认情况下声音很大。
版本 1.3 将完全删除被弃用的 API。

注意，按照 Django 的策略，文档中没有提到的框架的任何部分通常都应该被视为私有 API，并且可能会发生更改。

升级 (Upgrading)

要将 Django REST framework 升级到最新版本，请使用 pip：

pip install -U djangorestframework

您可以使用 pip show 确定当前安装的版本：

pip show djangorestframework

3.9.x 系列 (3.9.x series)

3.9.0

日期：2018年10月18日

ViewSet 额外操作的改进 #5605
修复 ViewSet 后缀的 action 支持 #6081
允许 action 文档部分 #6060
弃用 Router.register base_name 参数以支持 basename。#5990
弃用 Router.get_default_base_name 方法以支持 Router.get_default_basename。#5990
将 CharField 更改为不允许空字节。#6073 要恢复旧的行为，子类化 CharField 并从验证器中删除 ProhibitNullCharactersValidator。python class NullableCharField(serializers.CharField): def __init__(self, *args, **kwargs): super().__init__(*args, **kwargs) self.validators = [v for v in self.validators if not isinstance(v, ProhibitNullCharactersValidator)]
添加 OpenAPIRenderer 和 generate_schema 管理命令。#6229
默认情况下添加 OpenAPIRenderer，并添加模式文档。#6233
允许组合权限 #5753
在 Django 2.1 中允许可空的 BooleanField #6183
添加 Python 3.7 支持的测试 #6141
使用 Django 2.1 最终版本进行测试。#6109
将 djangorestframework-datatables 添加到第三方软件包 #5931
更改 ISO 8601 日期格式以排除年/月 #5936
将所有 pypi.python.org 网址更新到 pypi.org #5942
确保 html 表单 (多部分表单数据) 尊重可选字段 #5927
允许哈希 ErrorDetail。#5932
解析 JSONField 的正确模式 #5878
使用安全渲染描述 (来自 help_text) #5869
从 deault_error_message 中删除了输入值 #5881
在 DurationField 中添加 min_value/max_value 支持 #5643
修复实例被覆盖在 pk-only 优化 try/except 块 #5747
当值为 None 时，修复了项过滤器中的 AttributeError #5981
修复了 Javascript e.indexOf 不是函数错误 #5982
修复额外操作的模式 #5992
改进了 get_error_detail 以使用 error_dict/error_list #5785
Admin 渲染器中的改进 URL #5988
将 “社区” 部分添加到文档，进行小清理 #5993
将监护人的进口从兼容性移出 #6054
弃用 DjangoObjectPermissionsFilter 类，移动到 djangorestframework-guardian 包。#6075
放弃 Django 1.10 支持 #5657
只捕获对象查找的 TypeError/ValueError #6028
在 ModelSerializer 中处理没有 .objects 管理器的模型。#6111
改进 ModelSerializer.create() 错误消息。#6112
修复使用 django 1.11.6+ 会话认证时 CSRF cookie 检查失败 #6113
更新 JWT 文档。#6138
修复 autoescape 没有传递到 urlize_quoted_links 过滤器 #6191

3.8.x 系列 (3.8.x series)

3.8.2

日期：2018年4月6日

修复 read_only + default unique_together 验证。#5922
authtoken.views 从 rest_framework.compat 导入 coreapi，而不是直接导入。#5921
文档：向 Route 添加缺失的参数 ‘detail’ #5920

3.8.1

日期：2018年4月4日

在路由装饰器中使用旧的 url_name 行为 #5915
对于 list_route 和 detail_route，维护 url_name 的旧行为，基于 url_path 而不是函数名。

3.8.0

日期：2018年4月3日

突破更改：改变 read_only 加上 default 行为。#5886

read_only 字段现在将始终从可写字段中排除。

以前带有 default 值的 read_only 字段将使用 default 值来创建和更新操作。

为了维护旧行为，您可能需要在视图中调用 save() 时传递 read_only 字段的值：
```
def perform_create(self, serializer):
      serializer.save(owner=self.request.user)
```
或者，您可以根据需要在序列化器上重写 save() 或 create() 或 update()。
当 required=False 时纠正 allow_null 行为 #5888

没有显式的 default，allow_null 意味着输出序列化的默认值为 null。以前这些字段在只读或不需要时被跳过。

如果您依赖于从传出表示中排除的此类字段，则可能向后兼容性中断。为了恢复旧行为，您可以覆盖 data 以便在 None 时排除该字段。

例如：

@property
def data(self):
   """
   Drop `maybe_none` field if None.
   """
   data = super().data
   if 'maybe_none' in data and data['maybe_none'] is None:
       del data['maybe_none']
   return data

重构动态路由生成，提高视图集动作自省能力。#5705
ViewSets 已经被提供了新的属性和方法，允许它自省它的动作集和当前动作的细节。
- 将 list_route 和 detail_route 合并为 action 装饰器。
- 使用 .get_extra_actions() 在 ViewSet 上获取所有额外的操作。
- 额外操作现在在装饰方法上设置 url_name 和 url_path。
- url_name 现在基于函数名而不是 url_path，因为路径并不总是合适的 (例如，捕获路径中的参数)。
- 通过 .reverse_action() 方法启用操作 url 反转 (在 3.7.4 中添加)
- 反向调用示例：self.reverse_action(self.custom_action.url_name)
- 添加 detail initkwarg，以指示当前操作是否在集合或单个实例上操作。
额外的变化：
- 弃用 list_route 和 detail_route 以使用带有 detail 布尔值的 action 装饰器。
- 弃用动态列表/详细信息路由变体，支持带有 detail 布尔值的 DynamicRoute。
- 重构路由器的动态路由生成。
- list_route 和 detail_route 维护 url_name 的旧行为，基于 url_path 而不是函数名。
修复 3.7.4 发行说明的格式 #5704
文档：更新 DRF 可写嵌套序列化器参考 #5711
文档：修复认证 URL 示例中的拼写错误。#5713
改进复合字段子错误 #5655
禁用 dict/list 字段的 HTML 输入 #5702
修复 HostNameVersioning 文档中的拼写错误 #5709
使用 rsplit 获取导入的模块和类名 #5712
形式化 URLPatternsTestCase #5703
添加异常翻译测试 #5700
测试静态文件 #5701
将 drf-yasg 添加到文档和架构第三方软件包中 #5720
删除未使用的 compat._resolve_model() #5733
终止不支持 Python 3.2 的兼容解决方法 #5734
喜欢 iter(dict) 胜过 iter(dict.keys()) #5736
将 python_requires 参数传递给 setuptools #5739
从文档中删除未使用的链接 #5735
当可用的链接在文档，首选 https 协议 #5729
添加 HStoreField，postgres 字段测试 #5654
始终完全限定文档中的 ValidationError #5751
从 ManualSchema 中删除无法访问的代码 #5766
允许自定义 API 文档代码示例 #5752
更新文档以使用 pip show #5757
在模板中加载 ‘static’ 而不是 ‘staticfiles’ #5773
修复了 fields 文档中的拼写错误 #5783
在文档中请参考 “NamespaceVersioning” 而不是 “NamespacedVersioning” #5754
ErrorDetail：添加 __eq__/__ne__ 和 __repr__ #5787
更换文档中 background-attachment: fixed #5777
使 404 和 403 响应与 exceptions.APIException 输出一致 #5763
对 API 文档的小修正：模式 #5796
修复 PrimaryKeyRelatedField 的模式生成 #5764
将序列化器 DictField 表示为模式中的对象 #5765
添加了文档示例重新实现 ObtainAuthToken #5802
将模式添加到 ObtainAuthToken 视图 #5676
修复请求表单数据处理 #5800
修正 authtoken 视图导入 #5818
更新 pytest，isort #5815 #5817 #5894
修复了对非 ISO8601 日期时间的活跃时区处理。#5833
当值为 0 时，使 TemplateHTMLRenderer 渲染 IntegerField 输入。#5834
修正了教程说明中的端点 #5835
将 Django Rest Framework 角色过滤器添加到第三方软件包 #5809
使用静态资产的单一副本。更新 jQuery #5823
将三元条件更改为符合 PEP308 #5827
添加链接到 ‘A Todo List API with React’ 和 ‘Blog API’ 教程 #5837
修复 ModelSerializer 中的注释错误 #5844
将 admin 添加到已安装的应用程序以避免测试失败。#5870
修复了 SimpleMetadata 中 UUIDField 的模式。#5872
修正路由器上的文档包括命名空间。#5843
使用模型对象测试虚线源默认值。#5880
允许遍历可空相关字段 #5849
补充：教程：使用 React 的 Django REST (Django 2.0) #5891
添加 LimitOffsetPagination.get_count 以允许方法覆盖 #5846
不要在元数据中显示隐藏字段 #5854
启用 OrderingFilter 以处理 “ordering” 字段的空元组 (或列表)。#5899
添加了通用的 500 和 400 JSON 错误处理程序。#5904

3.7.x 系列 (3.7.x series)

3.7.7

日期：2017年12月21日

修复将 *.mo 现场文件包含到打包中的拼写错误。#5697，#5695

3.7.6

日期：2017年12月21日

将缺少的 *.ico 图标文件添加到包装中。

3.7.5

日期：2017年12月21日

将缺少的 *.woff2 字体文件添加到打包中。#5692
将缺少的 *.mo 语言环境文件添加到打包中。#5695，#5696

3.7.4

日期：2017年12月20日

模式：提取 manual_fields 处理的方法 #5633

允许更轻松地自定义 manual_fields 处理，例如，提供每个方法的手动字段。AutoSchema 添加了 get_manual_fields 作为预期的覆盖点，以及实用的方法 update_fields，用于处理列表中按名称字段替换，通常，您不应该覆盖该列表。

注意：AutoSchema.__init__ 现在确保 manual_fields 是一个列表。以前可能在内部存储为 None。
删除 ulrparse 兼容性垫片；用六个代替 #5579
为 TimeDelta.total_seconds() 删除兼容包装器 #5577
清理整个项目中的所有空白 #5578
兼容清理 #5581
在可浏览的 API 视图中添加 pygments CSS 块 #5584 #5587
从兼容中删除 set_rollback() #5591
修复请求主体/POST 访问 #5590
重命名测试以引用正确的问题 #5610
文档修复 #5611 #5612
在文档和代码中删除对不受支持的 Django 版本的引用 #5602
测试序列化器排除已声明的字段 #5599
修复了过滤后端的模式生成 #5613
ModelSerializer 测试的小清理 #5598
重新实现请求属性访问 w/__getattr__ #5617
修复了 SchemaJSRenderer 渲染无效的 Javascript #5607
使 Django 2.0 支持官方/显式 #5619
对传递的请求参数执行类型检查 #5618
修复请求验证器上的 AttributeError 隐藏 #5600
更新测试要求 #5626
文档：Serializer._declared_fields 启用修改序列化器上的字段 #5629
修复打包 #5624
修复 PyPI 的 readme 渲染，向 CI 添加 readme 构造 #5625
更新教程 #5622
带有 allow_null=True 的非必需字段不应该表示默认值 #5639
文档：添加 allow_null 序列化输出注释 #5641
更新在 tox.ini 中使用 Django 2.0 版本 #5645
修复 Serializer.data 在提供无效 data 时可浏览 API 渲染 #5646
文档：注意裸露 APIView 上的 AutoSchema 限制 #5649
将 .basename 和 .reverse_action() 添加到 ViewSet #5648
文档：修复序列化器文档中的拼写错误 #5652
修复 override_settings 兼容 #5668
添加 DEFAULT_SCHEMA_CLASS 设置 #5658
添加文档说明重新生成等于 required=False 的 BooleanField #5665
添加 ‘dist’ 构建 #5656
修复 docstring 中的拼写错误 #5678
文档：添加 UNAUTHENTICATED_USER = None 注释 #5679
从 “记录您的 API” 更新 OPTIONS 示例 #5680
文档：添加 FBVs 关于对象权限的说明 #5681
文档：向 to_representation 文档添加示例 #5682
在文档中添加链接到高级 DRF #5683
文档 ViewSet.action #5685
修复模式文档拼写错误 #5687
修复模式生成中的 URL 模式解析 #5689
添加使用 source ='*' 的示例到自定义字段文档。#5688
修复 Django 2 path() 路由的 format_suffix_patterns 行为 #5691

3.7.3

日期：2017年11月6日

修复从 contrib.auth 视图导入的 AppRegistryNotReady 错误 #5567

3.7.2

日期：2017年11月6日

修复了因删除 django.contrib.auth.login()/logout() 视图而导致的 Django 2.1 兼容性问题。#5510
为 TextLexer 添加缺少的导入。#5512
添加缓存的示例和文档 #5514
包括模式生成的日期和日期时间格式 #5511
对 markdown 代码块使用三重反引号 #5513
交互式文档 - 使底部边栏项成为粘性 #5516
澄清分页系统检查 #5524
停止 JSONBoundField 矫直无效的 JSON #5527
让 JSONField 在可浏览 API 中渲染为 textarea #5530
模式：排除 ViewSet 操作的 OPTIONS/HEAD #5532
修复点源的排序 #5533
修正：带有 allow_null=True 的字段应该意味着默认的序列化值 #5518
确保 Location 标头是严格的 “str”，而不是子类。#5544
向 api-guide/parsers 中的示例添加导入 #5547
捕获“超出范围”日期时间的OverflowError #5546
将 djangorestframework-quickjson 添加到第三方软件包 #5549
增加 drf_create_token 命令的测试覆盖率 #5550
添加 Python 3.6 支持的 trove 分类器。#5555
将 pip 缓存支持添加到 Travis CI 配置 #5556
将 [wheel] 部分重命名为 [bdist_wheel]，因为前者是遗留的 #5557
修复无效的转义序列弃用警告 #5560
添加交互式文档错误模板 #5548
将舍入参数添加到 DecimalField #5562
修复测试期间捕获的所有 BytesWarning #5561
使用 dict 和 set 字面值，而不是对 dict() 和 set() 的调用 #5559
更改 ImageField 验证模式，使用 DjangoImageField 中的验证器 #5539
修复 Python 2 处理 query_string 中的 unicode 符号 #5552

3.7.1

日期：2017年10月16日

修复交互式文档始终对请求中的布尔字段使用 false #5492
改善与 Django 2.0 alpha 的兼容性。#5500 #5503
模式命名冲突的改进处理 #5486
添加了其他文档和测试，围绕为点 source 字段提供默认值 #5489

3.7.0

日期：2017年10月6日

修复 DjangoModelPermissions，以确保在调用视图的 get_queryset() 方法之前进行用户身份验证。作为副作用，这会更改 HTTP 方法权限和身份验证检查的顺序，并且只有在进行身份验证时才会返回 405 响应。如果您想复制旧的行为，请参阅 PR 以获取详细信息。#5376
弃用 APIView 和 api_view 装饰器上的 exclude de_from_schema。酌情地设置 schema = None 或 @schema(None)。#5422
时区已知的 DateTimeFields 现在在序列化期间遵循活动或默认时区，而不总是使用 UTC。#5435

解决了不一致问题，实例被提供的 datetime 序列化以进行 create，但使用 UTC 进行 retrieve。#3732

如果依赖于 UTC 的 datetime 字符串，则可能会出现向后兼容中断。如果需要，让客户端解释 datetimes 或将默认或活跃时区 (文档) 设置为 UTC。
删除了与弃用策略内联的 DjangoFilterBackend。请改用 django_filters.rest_framework.FilterSet 和/或 django_filters.rest_framework.DjangoFilterBackend。#5273
不要在编码时剥离微秒。与 datetime 保持一致。BC 变化：以前只有毫秒被编码。#5440
添加了 STRICT_JSON 设置 (默认为 True) 来引发 Python 的 json 模块所接受的扩展浮动值 (nan，inf，-inf) 的异常。BC 变化：以前，这些值将转换为相应的字符串。将 STRICT_JSON 设置为 False 以恢复先前的行为。#5265
在 CursorPaginator 类中添加对 page_size 参数的支持 #5250
默认情况下，让 DEFAULT_PAGINATION_CLASS 为 None。BC 变化：如果您只设置 PAGE_SIZE 来启用分页，则需要添加 DEFAULT_PAGINATION_CLASS。以前的默认值是 rest_framework.pagination.PageNumberPagination。有一个系统检查警告来捕捉这种情况。如果您在每个视图的基础上设置分页类，那么您可以对此保持沉默。#5170
在模式生成中从 get_serializer_fields 捕获 APIException。#5443
使用 include_docs_urls 时，允许自定义身份验证和权限类 #5448
推迟在验证器上翻译字符串评估。#5452
将 ‘detail’ 参数的默认值添加到 ‘ValidationError’ 异常中 #5342
调整模式 get_filter_fields 规则以匹配框架 #5454
更新测试矩阵以添加 Django 2.0 并删除 Django 1.8 和 1.9 BC 变化：这将从 Django REST Framework 支持的版本中删除 Django 1.8 和 Django 1.9。#5457
修复了serializers.ModelField中的弃用警告 #5058
当 get_queryset 返回 None 时，添加了更明确的错误消息 #5348
修复响应 data 描述的文档 #5361
修复 pycache/.pyc 在包装时排除 #5373
修复点源的默认值处理 #5375
当将空主体传递给 RequestFactory 时，确保设置了 content_type #5351
修复 ErrorDetail 文档 #5380
允许通用内容表单中的可选内容 #5372
更新了 NullBooleanField 的受支持值 #5387
模型上使用 source 修复 ModelSerializer 自定义命名字段 #5388
修复 MultipleFieldLookupMixin 文档示例，以正确检查对象级权限 #5398
更新 permissions.md 中的 get_object() 示例 #5401
修正 authtoken 管理命令 #5415
修复模式生成 markdown #5421
允许动态设置 ChoiceField.choices #5426
将项目布局添加到快速入门 #5434
在 “render_markdown” templatetag 中重用 “apply_markdown” 函数 #5469
在文档中添加链接到 drf-openapi 包 #5470
添加了用 pygments 高亮显示的文档字符串代码 #5462
修复了名为 data 的视图的文档渲染 #5472
文档：澄清 “to_internal_value()” 验证行为 #5466
修复 APIException.str 上丢失的 six.text_type() 调用 #5476
文档 documentation.py #5478
修复模式生成中的命名冲突 #5464
使用请求对象调用 Django 的身份验证函数 #5295
将 coreapi JS 更新为 0.1.1 #5479
is_list_view 是否能够识别 RetrieveModel… views #5480
删除 Django 1.8 和 1.9 兼容性代码 #5481
从 DefaultRouter 中删除已弃用的模式代码 #5482
重构模式生成以允许按视图自定义。BC 变化：SchemaGenerator.get_serializer_fields 已被重构为 AutoSchema.get_serializer_fields 并删除了 view 参数

3.6.x 系列 (3.6.x series)

3.6.4

日期：2017年8月21日

忽略 OrderingFilter 的任何无效的查询参数。#5131
在读取大型 JSON 请求时改善内存占用。#5147
修复分页的模式生成。#5161
修复 HTML_CUTOFF 设置为 None 时的异常。#5174
修复可浏览的 API 不正确支持 multipart/form-data。#5176
修复 test_hyperlinked_related_lookup_url_encoded_exists。#5179
确保 max_length 在 FileField kwargs 中。#5186
使用 kwargs 修复 list_route 和 detail_route 在 url_path 中包含大括号 #5187
添加 Django 管理命令来创建 DRF 用户令牌。#5188
确保 API 文档模板不检查用户身份验证 #5162
修复 OneToOneField 也是主键的特殊情况。#5192
在 base.html 中添加 aria-label 和用于可访问性目的的新区域 #5196
引用 api.js 中的嵌套 API 参数 #5214
调度前设置 ViewSet args/kwargs/请求。#5229
为 SlugField 添加 unicode 支持。#5231
修复 HiddenField 以原始数据形式呈现初始内容。#5259
在无效时区解析时引发验证错误。#5261
修复 SearchFilter 到多个行为/性能。#5264
简化的链式比较和次要代码修复。#5276
RemoteUserAuthentication, docs, and tests. #5306
还原 “缓存字段的根和上下文属性” #5313
修复模式中列表字段的内省。#5326
修复多个嵌套和额外方法的交互式文档。#5334
修复/删除未定义的模板变量 “schema” #5346

3.6.3

日期：2017年5月12日

如果 URL 查找导致 ValidationError，则引发 404 错误。#5126
在生成 API 模式时，在基于类的视图上尊重 http_method_names。#5085
允许在 LimitOffsetPagination 中覆盖 get_limit 以返回所有记录。#4437
修复 ListSerializer 的部分更新。#4222
在可浏览的 API 中正确渲染 JSONField 控件。#4999 #5042
在给定时区中为无效的 datetime 引发验证错误。#4987
支持限制文档和模式快捷方式到 url 子集。#4979
使用没有 page_size 属性的分页器解决 SchemaGenerator 错误。#5086 #3692
用 %20 而不是空格解决字符串上的 HyperlinkedRelatedField 异常。#4748 #5078
可定制的模式生成器类。#5082
更新响应中现有的变化标头，而不是覆盖它们。#5047
支持将 .as_view() 传递给视图实例。#5053
在视图上覆盖设置时使用正确的异常处理程序。#5055 #5054
更新布尔字段以支持 “yes” 和 “no” 值。#5038
修复 ChoiceField 的唯一验证器。#5004 #5026 #5028
API 文档中的 JavaScript 清理。#5001
在有效的 API 模式中包含 URL 路径正则表达式。#5014
正确设置 coreapi TokenAuthentication 方案。#5000 #4994
ViewSet 上的 HEAD 请求不应返回 405。#4705 #4973 #4864
支持在 extra_kwargs 中使用 ‘source’。#4688
修复 schema.js 的无效内容类型 #4968
修复 DjangoFilterBackend 继承问题。#5089 #5117

3.6.2

日期：2017年3月10日

在 API 文档中支持 Safari 和 IE。#4959 #4961
在 API 文档模板标记中添加缺少的 mark_safe。#4952 #4953
添加缺少的 glyphicon 字体。#4950 #4951
修复 API 文档中的一对一字段。#4955 #4956
测试清理。#4949

3.6.1

日期：2017年3月9日

确保 markdown 依赖是可选的。#4947

3.6.0

日期：2017年3月9日

请参阅发布公告。

3.5.x 系列 (3.5.x series)

3.5.4

日期：2017年2月10日

为 ListField 添加 max_length 和 min_length 参数。#4877
添加按照视图自定义异常处理程序支持。#4753
支持禁用序列化器子类上声明的字段。#4764
支持 @list_route 和 @detail_route 端点上的自定义视图名称。#4821
使用自定义用户模型时，更正登录模板中字段的标签。#4841
空格修复了从文档字符串生成的描述。#4759 #4869 #4870
没有模式渲染的视图返回模式时，会更好的错误报告。#4790
修复了使用 prefetch_related 时 PUT 请求的返回响应。#4661 #4668
修复了痕迹视图名称。#4750
修复 RequestsClient 以确保完全限定的 URL。#4678
修复了某些情况下可写嵌套字段检查不正确的行为。#4634 #4669
解决 Django 弃用警告。#4712
各种测试用例的清理。

3.5.3

日期：2016年11月7日

不要引发不正确的 FilterSet 弃用警告。#4660 #4643 #4644
在视图权限类执行时，模式生成不应该引发 404。#4645 #4646
为输入控件添加 autofocus 支持。#4650

3.5.2

日期：2016年11月1日

在 Python 2.7 中恢复异常回溯。#4631 #4638
在管理控制台中正确显示 dicts。#4532 #4636
修复了带有变量 args，kwargs 的 is_simple_callable。#4622 #4602
使用 BooleanField 支持 ‘on’/‘off’ 文字。#4640 #4624
启用值查询集的游标分页。#4569
修复了对限流异常的 get_full_details()支持。#4627
修复 FilterSet 代理。#4620
使序列化器字段显式导入。#4628
删除冗余请求适配器。#4639

3.5.1

日期：2016年10月21日

创建 rest_framework/compat.py 导入。#4612 #4608 #4601
修复模式基础路径生成中的 bug。#4611 #4605
修复单一项的 ListSerializer 的破损情况。#4609 #4606
删除 Python 3.5 兼容的空白 raise。#4600

3.5.0

日期：2016年10月20日

3.4.x 系列 (3.4.x series)

3.4.7

日期：2016年9月21日

request.POST 已经被访问时请求解析的回退行为。#3951 #4500
修复 RegexField 的回归。#4489 #4490 #2617
admin.html 中缺少逗号导致 CSRF 错误。#4472 #4473
修复带有空上下文的响应渲染。#4495
修复 API 列表中的缩进回归。#4493
修复了将错误值设置为 api_view 装饰视图的 ResolverMatch.func_name 的问题。#4465 #4462
修复路径包含 unicode 参数时的 APIClient.get() #4458

3.4.6

日期：2016年8月23日

修复可浏览 API 中难看的的 Javascript。#4435
从模式字段中跳过 HiddenField。#4425 #4429
改进 Create 以显示原始异常回溯。#3508
修复 AdminRenderer 仅显示 PK 相关字段。#4419 #4423

3.4.5

日期：2016年8月19日

改善调试错误处理。#4416 #4409
允许自定义 CSRF_HEADER_NAME 设置。#4415 #4410
生成模式时在视图集上包含 .action 属性。#4408 #4398
请勿在 request.POST 中包含 request.FILES 项。#4407
修复了多重复选框的渲染。#4403
修复 Field.get_default 的文档字符串。#4404
用 README 中的 ascii 对应字符替换 utf8 字符。#4412

3.4.4

日期：2016年8月12日

确保在生成模式时完全初始化视图。#4373 #4382 #4383 #4279 #4278
将表单字段描述添加到模式。#4387
修复模式端点的类别生成。#4391 #4394 #4390 #4386 #4376 #4329
分页时不要剥离空的查询参数。#4392 #4393 #4260
不要对带有 LimitOffsetPagination 的空结果重新运行查询。#4201 #4388
对 CharField 进行更严格的类型验证。#4380 #3394
RelatedField.choices 应保留非字符串值。#4111 #4379 #3365
在垂直窗体样式中渲染复选框的测试用例。#4378 #3868
在可浏览的 API 中显示错误回溯 HTML #4042 #4172
修复 ALLOWED_VERSIONS 和没有 DEFAULT_VERSION 的处理。#4370
在 DecimalField 上允许 max_numbers=None。#4377 #4372
在渲染关系选择时限制查询集。#4375 #4122 #3329 #3330 #3877
解决 ChoiceField、MultipleChoiceField 和非字符串选项表单显示。#4374 #4119 #4121 #4137 #4120
修复对 TemplateHTMLRenderer.resolve_context() 回退方法的调用。#4371

3.4.3

日期：2016年8月5日

包含旧版 TemplateHTMLRenderer 内部 API 用户的回退。#4361

3.4.2

日期：2016年8月5日

在生成模式时将 kwargs 传递给 ‘as_view’。#4359 #4330 #4331
在 Django 1.10+ 下访问 request.user.is_authenticated 作为属性而不是方法 #4358 #4354
从模式中过滤出 HEAD。#4357
extra_kwargs 优先于唯一性 kwargs。#4198 #4199 #4349
在代码缩进中使用制表符时的正确描述。#4345 #4347
在 TemplateHTMLRenderer 中更改模板上下文生成。#4236
序列化器默认值不应该包含在部分更新中。#4346 #3565
当文件名未被包含时，从 FileUploadParser 始终如一的行为和描述错误。#4340 #3610 #4292 #4296
DecimalField 量化传入的数字。#4339 #4318
处理 IP 字段的非字符串输入。#4335 #4336 #4338
当模式生成包含根 URL 时，修复前导斜杠处理。#4332
带有 allow_null 选项的 DictField 测试用例。#4348
更新从 Django 1.10 beta 到 Django 1.10 的测试。#4344

3.4.1

日期：2016年7月28日

向 DefaultRouter 添加 root_renderers 参数。#4323 #4268
添加了 url 和 schema_url 参数。#4321 #4308 #4305
唯一的一起检查应该适用于具有默认值的只读字段。#4316 #4294
在模式生成器中设置 view.format_kwarg。#4293 #4315
修复带有 pagination_class = None 的视图的模式生成器。#4314 #4289
修复没有 get_serializer_class 的视图的模式生成器。#4265 #4285
修复了 Accept 和 Content-Type 标头中的媒体类型参数。#4287 #4313 #4281
在错误消息中使用 verbose_name 而不是 object_name。#4299
Twitter Bootstrap 的小版本更新。#4307
使用相关字段时，SearchFilter 会引发错误。#4302 #4303 #4298
添加对 RFC 4918 状态代码的支持。#4291
将 LICENSE.md 添加到构建的 wheel 中。#4270
序列化 “complex” 字段返回 None，而不是 3.4 之后的值 #4272 #4273 #4288

3.4.0

日期：2016年7月14日

不要在 JSON 输出中剥离微秒。#4256
两个稍微不同的 iso 8601 日期时间序列化。#4255
解决不正确的包含媒体类型参数。#4254
响应内容类型可能存在缺陷。#4253
修复某些平台上的 setup.py 错误。#4246
将 coreapi 中的替代格式移动到单独的包中。#4244
将局部关键字参数添加到 DecimalField。#4233
修复自定义列表路由和详细路由中的路由器问题。#4229
具有嵌套命名空间的命名空间版本控制。#4219
强大的唯一性检查。#4217
must_call_distinct 的轻微重构。#4215
CursorPagination 中的可覆盖偏移截止。#4212
像日期/时间字段一样传递字符串。#4196
添加测试确认 required=False 在关系字段上有效。#4195
在 LimitOffsetPagination 中，limit=0 应恢复为默认限制。#4194
从 unique_together 验证和添加文档中排除 read_only=True 字段。#4192
处理 JSON 中的字节串。#4191
JSONField(binary=True) 表示使用二进制字符串，JSONRenderer 不支持二进制字符串。#4187 #4185
可浏览 API 中更强大的表单渲染。#4181
.validated_data 和 .errors 的空用例作为 ListSerializer 的列表，而不是 dicts。#4180
模式和客户端库。#4179
删除了 AUTH_USER_MODEL 兼容属性。#4176
清理现有的弃用警告。#4166
Django 1.10 支持。#4158
将 jQuery 版本更新为 1.12.4。#4157
OrderingFilter 上更强大的默认行为。#4156
description.py 代码和测试删除。#4153
在元组中包裹 guardian.VERSION。#4149
为具有 kwargs 的字段优化验证器。#4146
修复 ListField，DictField 的子节点中的无值表示。#4118
解析午夜值的 TimeField 表示。#4107
在 POST/DELETE 请求之后，在 AdminRenderer 中为重定向设置正确的状态码。#4106
TimeField 渲染返回 None 而不是 00:00:00。#4105
修复错误命名的 zh-hans 和 zh-hant 区域设置路径。#4103
限制为 0 时防止引发异常。#4098
TokenAuthentication：在标头中允许自定义关键字。#4097
处理错误填充的 HTTP 基本认证头。#4090
LimitOffset 分页在 limit=0 时崩溃可浏览 API。#4079
修复了 DecimalField 的任意精度支持。#4075
添加了对自定义 CSRF cookie 名称的支持。#4049
修复 #4035 引入的回归。#4041
没有身份验证视图失败许可应引发 403。#4040
修复 string_types / text_types 混淆。#4025
不要在 OPTIONS 请求中列出相关的字段选项。#4021
修复拼写错误。#4008
重新排序初始化视图。#4006
在 Python 3.4 上的 DjangoObjectPermissionsFilter 中类型错误。#4005
修复使用已弃用的 Query.aggregates。#4003
修复文档字符串周围的空白行。#4002
修正了限制为 0 时的管理员分页。#3990
OrderingFilter 调整。#3983
非必需的序列化器相关字段。#3976
在教程中使用更安全的 “@api_view” 调用方式。#3971
ListSerializer 不处理 unique_together 约束。#3970
添加缺少的迁移文件。#3968
OrderingFilter 应调用 get_serializer_class() 来确定默认字段。#3964
从测试和兼容中删除旧的 Django 检查。#3953
支持 callable 作为任何 serializer.Field 的 initial 值。#3943
在 SearchFilter 中阻止不必要的 distinct() 调用。#3938
修复 None UUID ForeignKey 序列化。#3936
删掉 EOL Django 1.7。#3933
在序列化器错误消息中添加丢失的空格。#3926
修复 _force_text_recursive 拼写错误。#3908
尝试处理 Django 2.0 与 field.rel 相关的弃用警告。#3906
修复使用带列表的嵌套序列化器解析多部分数据。#3820
将 API URL 解析为不同的命名空间。#3816
不要在可浏览的 API 表单中使用 HTML 转义 help_text。#3812
OPTIONS 在选项字段中获取并显示所有可能的外键。#3751
Django 1.9 弃用警告 #3729
#3598 的测试用例 #3710
添加对搜索过滤器的多个值的支持。#3541
在排序过滤器中使用 get_serializer_class。#3487
具有 many=True 的序列化器应返回空列表而不是空字典。#3476
LimitOffsetPagination limit=0 修复。#3444
启用验证器延迟字符串评估并处理新的字符串格式。#3438
如果字段无效，则唯一验证器被执行并断开。#3381
不要忽略面包屑中覆盖的 View.get_view_name()。#3273
当渲染序列化器失败时，重试表单渲染。#3164
唯一约束防止嵌套的序列化器更新。#2996
唯一性验证器不应该排除 (read_only) 字段运行。#2848
UniqueValidator 会引发嵌套对象的异常。#2403
lookup_type 已弃用，支持 lookup_expr。#4259

3.3.x 系列 (3.3.x series)

3.3.3

日期：2016年3月14日。

从模板中删除版本字符串。感谢 @blag 的报告和修复。#3878 #3913 #3912
修复 BooleanField 的垂直 html 布局。感谢 Mikalai Radchuk 的修复。#3910
Django 1.8 上的静默弃用警告。感谢 Simon Charette 的修复。#3903
authtoken 的国际化。感谢 Michael Nacharov 的修复。#3887 #3968
当 authtoken 应用程序未声明时，将 Token 模型修正为 abstract。感谢 Adam Thomas 的报告。#3860 #3858
改善 Markdown 版本兼容性。感谢 Michael J. Schultz 的修复。#3604 #3842
QueryParameterVersioning 不使用 DEFAULT_VERSION 设置。感谢 Brad Montgomery 的修复。#3833
在模型上添加显式的 on_delete。感谢 Mads Jensen 的修复。#3832
修复 DateField.to_representation 以便与 Python 2 unicode 一起工作。感谢 Mikalai Radchuk 的修复。#3819
修复了 TimeField 不处理字符串时间。感谢 Areski Belaid 的修复。#3809
避免更新 Meta.extra_kwargs。感谢 Kevin Massey 的报告和修复。#3805 #3804
修复了嵌套验证错误被错误渲染。感谢 Craig de Stigter 的修复。#3801
记录如何使用 django-crispy-forms 避免 CSRF 和缺少按钮问题。感谢 Emmanuelle Delescolle，JoséPadilla 和 Luis San Pablo 的报告，分析和修复。#3787 #3636 #3637
改进 Rest Framework 设置文件建立时间。感谢 Miles Hutson 的报告和 Mads Jensen 的修复。#3786 #3815
改进 Django 1.9 的 authtoken 兼容性。感谢 S. Andrew Sheppard 的修复。#3785
修复模型的 DecimalField 中的 Min/MaxValueValidator 传输。感谢 Kevin Brown 的修复。#3774
改进可浏览 API 中的 HTML 标题。感谢 Mike Lissner 的报告和修复。#3769
修复 AutoFilterSet 以继承 default_filter_set。感谢 Tom Linford 的修复。#3753
修复 transifex 配置以处理新的中文语言代码。感谢 @nypisces 的报告和修复。#3739
DateTimeField 无法正确处理空值。感谢 Mick Parker 的报告和修复。#3731 #3726
设置删除的 rest_framework 设置时引发错误。感谢 Luis San Pablo 的修复。#3715
在 AdminRenderer post 表单中添加缺少的 csrf_token。感谢 PiotrŚniegowski 的修复。#3703
重构 _get_reverse_relationships() 以使用正确的 to_field。感谢 Benjamin Phillips 的修复。#3696
记录有关 RelatedField 的 get_queryset 的使用。感谢 Ryan Hiebert 的修复。#3605
修复 HyperlinkRelatedField.get_url 中的空 pk 检测。感谢 @jslang 的修复。#3962

3.3.2

日期：2015年12月14日。

ListField 强制输入是一个列表。#3513
修复隐藏原始数据表单的回归。#3600 #3578
修复 Python 3.5 兼容性。#3534 #3626
允许在 pagination.PageNumberPagination 中设置自定义 Django Paginator。#3631 #3684
修复没有 to_fields 属性的关系字段。#3635 #3634
修复 Django 1.9 的 template.render 弃用警告。#3654
在可浏览的 API 呈现器中对响应头进行排序。#3655
对 Django 1.9+ 使用 related_objects api。#3656 #3252
删除时添加确认模式。#3228 #3662
在调用 has_[object_]permissions 时显示以前隐藏的 AttributeErrors 和 TypeErrors。#3668
使 DRF 与 Django 1.8 中的多模板引擎兼容。#3672
更新 NestedBoundField 以在渲染其表单时处理空字符串。#3677
修复 UUID 验证以正确捕获无效输入类型。#3687 #3679
修复缓存问题。#3628 #3701
修复没有 filter_class 的视图的管理员和 API 浏览器。#3705 #3596 #3597
将 app_name 添加到 rest_framework.urls。#3714
改进 authtoken 的视图以支持 url 版本控制。#3718 #3723

3.3.1

日期：2015年11月4日。

访问 request.POST 时解决解析错误 #3592
正确处理引用主键的 to_field。#3593
当没有定义 filter_class 时，允许过滤 HTML 去渲染。#3560
修复管理员渲染问题。#3564 #3556
修复了 DecimalValidator 的问题。#3568

3.3.0

日期：2015年10月28日。

过滤器的 HTML 控件。#3315
Forms API。#3475
AJAX 可浏览的 API。#3410
添加 JSONField。#3454
在创建 ModelSerializer 关系字段时正确映射 to_field。#3526
将 FilePathField 映射到序列化器字段时包含关键字参数。#3536
在 ModelSerializer 唯一性约束上映射适当的模型 error_messages。#3435
包括从 TextField 映射的 ModelSerializer 字段的 max_length 约束。#3509
添加了对 Django 1.9 的支持。#3450 #3525
删除了对 Django 1.5 和 1.6 的支持。#3421 #3429
删除了 “south” 迁移。#3495

3.2.x 系列 (3.2.x series)

3.2.5

日期：2015年10月27日。

在可选的注销标记中转义 username。#3550

3.2.4

日期：2015年9月21日。

不要错过缺失的 ViewSet.search_fields 属性。#3324 #3323
修复了 allow_empty 无法在带有 many=True 的序列化器上工作。#3361 #3364
让 DurationField 接受整数。#3359
多部分请求中不支持多级词典。#3314
修复 HTTP PATCH 上的 ListField 截断 #3415 #2761

3.2.3

日期：2015年8月24日。

为限制选择下拉菜单添加 html_cutoff 和 html_cutoff_text。#3313
添加正则表达式样式到 SearchFilter。#3316
解决设置空白 HTML 字段的问题。#3318 #3321
在可浏览的 API 表单中正确显示现有的 “选择多个” 值。#3290
解决 IPAddressField 的重复验证消息。#3249 #3250
修复以确保在禁用分页时管理渲染器继续工作。#3275
当 count=0，offset=0 时，解决与 LimitOffsetPagination 的错误 #3303

3.2.2

日期：2015年8月13日。

添加 display_value() 方法，以便在显示关系字段选择输入时使用。#3254
修复了 BooleanField 复选框错误显示为已选中的问题。#3258
确保空复选框在所有情况下都将 BooleanField 正确设置为 False。#2776
允许 WSGIRequest.FILES 属性，而不引发不正确的已弃用错误。#3261
解决在表单中渲染嵌套序列化器的问题。#3260
如果用户偶然地将序列化器实例传递给响应而不是数据，则引发错误。#3241

3.2.1

日期：2015年8月7日。

修复了没有任何选项的关系选择小部件呈现。#3237
在管理界面中修复 1，0 渲染为 true，false。#3227
修复了在 HTML 表单输入中具有单个值的 ListFields。#3238
允许 request.FILES 与 Django 的 HTTPRequest 类兼容。#3239

3.2.0

日期：2015年8月6日。

添加 AdminRenderer。#2926
添加 FilePathField。#1854
将 allow_empty 添加到 ListField。#2250
支持 django-guardian 1.3。#3165
支持分组选择。#3225
支持可浏览 API 中的错误表单。#3024
允许权限类自定义错误消息。#2539
支持超链接字段上 source=<method>。#2690
ListField(allow_null=True) 现在允许 null 作为列表值，而不是列表中的空项。#2766
ManyToMany() 映射到 allow_empty=False，ManyToMany(blank=True) 映射到 allow_empty=True。#2804
支持主键字段的自定义序列化样式。#2789
OPTIONS 请求支持嵌套表示。#2915
为具有 OPTIONS 请求的视图集设置 view.action == "metadata"。#3115
支持 UUIDField 上的 allow_blank。
不显示包含 401 或 403 响应码的视图文档字符串。#3216
解决 Django 1.8 弃用警告。#2886
修复了 DecimalField 验证。#3139
修复与 trim_whitespace=True 一起使用时 allow_blank=False 的行为。#2712
修复了一些字段组合错误映射到无效 allow_blank 参数的问题。#3011
修复具有预取和修改的查询集的输出表示。#2704 #2727
修复了当 CursorPagination 被提供了某些无效的查询参数时的断言错误。#2920
修复当在带有 TokenAuthentication 的标头中包含的无效字符时的 UnicodeDecodeError。#2928
用 @non_atomic_requests 装饰器修复事务回滚。#3016
使用 SearchFilter 修复 Oracle 数据库的重复结果问题。#2935
修复可浏览 API 表单中的复选框对齐和呈现。#2783
修复在表示中应该使用 "url": null 的未保存的文件对象。#2759
修复可浏览 API 中的字段值渲染。#2416
修复 HStoreField 以在 DictField 映射中包含 allow_blank=True。#2659
许多其他的清理，错误消息的改进，私有 API 和小的修正。

3.1.x 系列 (3.1.x series)

3.1.3

日期：2015年6月4日。

添加 DurationField。#2481 #2989
将 format 参数添加到 UUIDField。#2788 #3000
MultipleChoiceField 使用 multipart/form-data 错误地对部分更新进行清空 #2993 #2894
修复与只读 RelatedField 相关的选项中的错误。#2981 #2811
修复具有 unique_together 关系的嵌套序列化器。#2975
允许 ChoiceField/MultipleChoiceField 表示的意外值。#2839 #2940
如果设置了 ATOMIC_REQUESTS，则在错误时回滚事务。#2887 #2034
当 override_method 不管其 None 状态时，在视图上设置操作。#2933
DecimalField 接受 2E+2 作为 200 并正确验证小数位。#2948 #2947
使用更改 username 的自定义 UserModel 支持基本身份验证。#2952
IPAddressField 的改进。#2747 #2618 #3008
改进 DecimalField，以便更容易子类化。#2695

3.1.2

日期：2015年5月13日。

DateField.to_representation 可以处理字符串和空值。#2656 #2687 #2869
使用 HTTP 标准中的默认原因短语。#2764 #2763
当将 ModelSerializer 与抽象模型一起使用时，会引发错误。#2757 #2630
在 HyperLinkedRelatedField 中处理非 API view_name 的逆转 #2724 #2711
不要对相关字段严格要求 pk。#2745 #2754
元数据检测空布尔字段类型。#2762
妥善处理嵌套序列化器中的深度。#2798
显示没有分页器的视图集。#2807
不要在权限中检查已弃用的 .model 属性 #2818
将整数字段限制为整数和字符串。#2835 #2836
改进 IntegerField 以使用编译的十进制正则表达式。#2853
阻止空 queryset 引发 AssertionError。#2862
DjangoModelPermissions 依赖于 get_queryset。#2863
把 AcceptHeaderVersioning 与内容协商核对。#2868
允许 DjangoObjectPermissions 使用定义 get_queryset 的视图。#2905

3.1.1

日期：2015年3月23日。

安全修复：可浏览 API 中的转义制表符切换 cookie 名。
如果使用 serializer_class，即使在视图中不存在 get_serializer 方法，也可以在可浏览的 API 中显示输入表单。#2743
使用 AuthTokenSerializer 的密码输入。#2741
修复下一个按钮后缺少的锚关闭标签。#2691
修复视图集中的 lookup_url_kwarg 处理。#2685 #2591
修复了在 apps.py 中导入 rest_framework.views 的问题 #2678
如果未设置 PAGE_SIZE，LimitOffsetPagination 会引发 TypeError #2667 #2700
min_value 字段错误消息的德语翻译引用 max_value。#2645
删除 MergeDict。#2640
支持序列化具有相关字段的未保存模型。#2637 #2641
在 radio.html 选项上允许空白/null。#2631

3.1.0

日期：2015年3月5日。

有关详细信息，请参阅 3.1 发布公告。

3.0.x 系列 (3.0.x series)

3.0.5

日期：2015年2月10日。

修复 _closable_objects 破坏序列化的错误。#1850 #2492
允许具有 Throttling 的非标准 User 模型。#2524
在 TokenAuthentication 迁移中支持自定义 User.db_table。#2479
修复 Request 对象上误导性的 AttributeError 回溯。#2530 #2108
在部分更新上 ManyRelatedField.get_value 清除字段。#2475
从代码中删除了 ‘.model’ 快捷方式。#2486
修复 detail_route 和 list_route 可变参数。#2518
在 TokenAuthentication 中获取令牌时预取用户对象。#2519

3.0.4

日期：2015年1月28日。

Django 1.8a1 支持。#2425 #2446 #2441
添加 DictField 并支持 Django 1.8 HStoreField。#2451 #2106
添加 UUIDField 并支持 Django 1.8 UUIDField。#2448 #2433 #2432
BaseRenderer.render 现在引发 NotImplementedError。#2434
修复 Python 2.6 上的 timedelta JSON 序列化。#2430
ResultDict 和 ResultList 现在表现为标准的字典/列表。#2421
修复 Web 浏览 API 页面的 HTML 表单中的可见 HiddenField。#2410
对 RelatedField.choices 使用 OrderedDict。#2408
修复使用 HTTP_X_FORWARDED_FOR 时的识别格式。#2401
使用限流时修复带有 memcached 的无效密钥。#2400
修复版本 3.x 的 FileUploadParser。#2399
修复序列化器继承。#2388
修复 ReturnDict 的缓存问题。#2360

3.0.3

日期：2015年1月8日。

修复 models.DateField 上的 MinValueValidator。#2369
使用分页时修复序列化器缺少上下文。#2355
DefaultRouter 现在支持命名空间的路由器 URL。#2351
required=False 允许输出值的遗漏。#2342
对 models.TextField 使用 textarea 输入。#2340
如果需要，使用自定义 ListSerializer 进行分页。#2331 #2327
使用 null 和 “空白 HTML 字段” 的更好行为。#2330
确保 exclude 中的字段是模型字段。#2319
修复 IntegerField 和 max_length 参数不兼容。#2317
修复了用于 3.0 序列化器的 YAML 编码器。#2315 #2283
修复空 HTML 字段的行为。#2311 #1101
修复元类属性深度忽略字段属性。#2287
修复 format_suffix_patterns 以用于 Django 的 i18n_patterns。#2278
能够使用 url_path 为自定义操作定制路由器 URL。#2010
不要将 Django REST Framework 安装为 egg。#2386

3.0.2

日期：2014年12月17日。

确保 request.user 可用于响应中间件。#2155
logout() 还取消了任何现有的 force_authenticate。#2218 #2259
额外的断言和更好的检查，以防止错误的序列化 API 使用。#2228 #2234 #2262 #2263 #2266 #2267 #2289 #2291
修复了 CharField 的 min_length 消息。#2255
修复了在序列化器 repr 上发生的 UnicodeDecodeError。#2270 #2279
提供默认值时修复空 HTML 值。#2280 #2294
修复 SlugRelatedField 在用作多选输入时引发 UnicodeEncodeError。#2290

3.0.1

日期：2014年12月11日。

当默认序列化器 create() 失败时，更有用的错误消息。#2013
如果数据无效，尝试保存序列化程序时引发错误。#2098
修复 FileUploadParser 打破空文件名和多个上传处理程序。#2109
改进 BindingDict 以支持标准的 dict 函数。#2135 #2163
向 ListSerializer 添加 validate()。#2168 #2225 #2232
修复 JSONP 渲染器无法转义某些字符。#2169 #2195
为 FileField 添加缺少的默认样式。#2172
调用 ViewSet.as_view() 时需要操作。#2175
向 ChoiceField 添加 allow_blank。#2184 #2239
HTML 渲染器中的修饰性修复。#2187
如果序列化器上的 fields 不是字符串列表，则引发错误。#2193 #2213
改进对嵌套创建和更新的检查。#2194 #2196
validated_attrs 参数在 Serializer create()/update() 中被重命名为 validated_data。#2197
删除已弃用的代码以反映已删除的 Django 版本。#2200
嵌套写入的更好的序列化器错误。#2202 #2215
修复分页和自定义权限不兼容。#2205
如果序列化器上的 fields 不是字符串列表，则引发错误。#2213
为关系字段添加缺少的翻译标记。#2231
改进 dicts/mappings 的字段查找行为。#2244 #2243
优化超链的 PK。#2242