Skip to content

Commit

Permalink
Version 3.13 (#8285)
Browse files Browse the repository at this point in the history
* Version 3.12.5

* Version 3.13

* Version 3.13
  • Loading branch information
tomchristie committed Dec 13, 2021
1 parent 9c97946 commit 7a84dc7
Show file tree
Hide file tree
Showing 4 changed files with 73 additions and 1 deletion.
55 changes: 55 additions & 0 deletions docs/community/3.13-announcement.md
@@ -0,0 +1,55 @@
<style>
.promo li a {
float: left;
width: 130px;
height: 20px;
text-align: center;
margin: 10px 30px;
padding: 150px 0 0 0;
background-position: 0 50%;
background-size: 130px auto;
background-repeat: no-repeat;
font-size: 120%;
color: black;
}
.promo li {
list-style: none;
}
</style>

# Django REST framework 3.13

## Django 4.0 support

The latest release now fully supports Django 4.0.

Our requirements are now:

* Python 3.6+
* Django 4.0, 3.2, 3.1, 2.2 (LTS)

## Fields arguments are now keyword-only

When instantiating fields on serializers, you should always use keyword arguments,
such as `serializers.CharField(max_length=200)`. This has always been the case,
and all the examples that we have in the documentation use keyword arguments,
rather than positional arguments.

From REST framework 3.13 onwards, this is now *explicitly enforced*.

The most feasible cases where users might be accidentally omitting the keyword arguments
are likely in the composite fields, `ListField` and `DictField`. For instance...

```python
aliases = serializers.ListField(serializers.CharField())
```

They must now use the more explicit keyword argument style...

```python
aliases = serializers.ListField(child=serializers.CharField())
```

This change has been made because using positional arguments here *does not* result in the expected behaviour.

See Pull Request [#7632](https://github.com/encode/django-rest-framework/pull/7632) for more details.
16 changes: 16 additions & 0 deletions docs/community/release-notes.md
Expand Up @@ -34,6 +34,22 @@ You can determine your currently installed version using `pip show`:

---

## 3.13.x series

### 3.13.0

Date: 13th December 2021

* Django 4.0 compatability. [#8178]
* Add `max_length` and `min_length` options to `ListSerializer`. [#8165]
* Add `get_request_serializer` and `get_response_serializer` hooks to `AutoSchema`. [#7424]
* Fix OpenAPI representation of null-able read only fields. [#8116]
* Respect `UNICODE_JSON` setting in API schema outputs. [#7991]
* Fix for `RemoteUserAuthentication`. [#7158]
* Make Field constructors keyword-only. [#7632]

---

## 3.12.x series

### 3.12.4
Expand Down
1 change: 1 addition & 0 deletions mkdocs.yml
Expand Up @@ -66,6 +66,7 @@ nav:
- 'Contributing to REST framework': 'community/contributing.md'
- 'Project management': 'community/project-management.md'
- 'Release Notes': 'community/release-notes.md'
- '3.13 Announcement': 'community/3.13-announcement.md'
- '3.12 Announcement': 'community/3.12-announcement.md'
- '3.11 Announcement': 'community/3.11-announcement.md'
- '3.10 Announcement': 'community/3.10-announcement.md'
Expand Down
2 changes: 1 addition & 1 deletion rest_framework/__init__.py
Expand Up @@ -10,7 +10,7 @@
import django

__title__ = 'Django REST framework'
__version__ = '3.12.4'
__version__ = '3.13.0'
__author__ = 'Tom Christie'
__license__ = 'BSD 3-Clause'
__copyright__ = 'Copyright 2011-2019 Encode OSS Ltd'
Expand Down

0 comments on commit 7a84dc7

Please sign in to comment.