encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2025-06-30 18:33:21 +03:00
Code Issues Packages Projects Releases Wiki Activity

Update release docs

Browse Source
This commit is contained in:
Tom Christie 2016-07-13 16:46:50 +01:00
parent e107c1dc35
commit 6f8a0f2a68
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/topics/3.4-announcement.md
View File

@ -119,7 +119,7 @@ The following versions of Python and Django are now supported:
The 3.4 release includes very limited deprecation or behavioral changes, and The 3.4 release includes very limited deprecation or behavioral changes, and
should present a straightforward upgrade. should present a straightforward upgrade.
#### Use fields or exclude on serializer classes. ### Use fields or exclude on serializer classes.
The following change in 3.3.0 is now escalated from "pending deprecation" to The following change in 3.3.0 is now escalated from "pending deprecation" to
"deprecated". Its usage will continue to function but will raise warnings: "deprecated". Its usage will continue to function but will raise warnings:
@ -128,7 +128,7 @@ The following change in 3.3.0 is now escalated from "pending deprecation" to
option, or an `exclude` option. The `fields = '__all__'` shortcut may be used option, or an `exclude` option. The `fields = '__all__'` shortcut may be used
to explicitly include all fields. to explicitly include all fields.
#### Microsecond precision when returning time or datetime ### Microsecond precision when returning time or datetime.
Using the default JSON renderer and directly returning a `datetime` or `time` Using the default JSON renderer and directly returning a `datetime` or `time`
instance will now render with microsecond precision (6 digits), rather than instance will now render with microsecond precision (6 digits), rather than
@ -145,6 +145,22 @@ and `TIME_FORMAT` settings.
The renderer behavior can be modified by setting a custom `encoder_class` The renderer behavior can be modified by setting a custom `encoder_class`
attribute on a `JSONRenderer` subclass. attribute on a `JSONRenderer` subclass.
### Relational choices no longer displayed in OPTIONS requests.
Making an `OPTIONS` request to views that have a serializer choice field
will result in a list of the available choices being returned in the response.
In cases where there is a relational field, the previous behavior would be
to return a list of available instances to choose from for that relational field.
In order to minimise exposed information the behavior now is to *not* return
choices information for relational fields.
If you want to override this new behavior you'll need to [implement a custom
metadata class][metadata].
See [issue #3751][gh3751] for more information on this behavioral change.
--- ---
## Other improvements ## Other improvements
@ -170,3 +186,5 @@ The full set of itemized release notes [are available here][release-notes].
[api-clients]: api-clients.md [api-clients]: api-clients.md
[milestone]: https://github.com/tomchristie/django-rest-framework/milestone/35 [milestone]: https://github.com/tomchristie/django-rest-framework/milestone/35
[release-notes]: release-notes#34 [release-notes]: release-notes#34
[metadata]: ../../api-guide/metadata/#custom-metadata-classes
[gh3751]: https://github.com/tomchristie/django-rest-framework/issues/3751