encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2024-09-21 11:29:01 +03:00
Code Issues Packages Projects Releases Wiki Activity
cf33008571
django-rest-framework/docs/topics/3.3-announcement.md
Tom Christie cf33008571 Release notes etc
2015-10-22 14:05:52 +01:00

3.0 KiB
Raw Blame History

Django REST framework 3.3

The 3.3 release marks the final work in the Kickstarter funded series. We'd like to offer a final resounding thank you to all our wonderful sponsors and supporters.

The amount of work that has been achieved as a direct result of the funding is immense. We've added a huge amounts of new functionality, resolved nearly 2,000 tickets, and redesigned & refined large parts of the project.

In order to continue

Release notes

Significant new functionality in the 3.3 release includes:

  • Filters presented as HTML controls in the browsable API.
  • A forms API, allowing serializers to be rendered as HTML forms.
  • Django 1.9 support.
  • A JSONField serializer field, corresponding to Django 1.9's Postgres JSONField model field.
  • Browsable API support via AJAX, rather than server side request overloading.

Filter Controls

Example of the new filter controls

Supported versions

This release drops support for Django 1.5 and 1.6. Django 1.7, 1.8 or 1.9 are now required.

This brings our supported versions into line with Django's currently supported versions

Deprecations

The AJAX based support for the browsable API means that there are a number of internal cleanups in the request class. For the vast majority of developers this should largely remain transparent:

  • To support form based PUT and DELETE, or to support form content types such as JSON, you should now use the [AJAX forms][ajax-forms] javascript library. This replaces the previous 'method and content type overloading' that required significant internal complexity to the request class.
  • The accept query parameter is no longer supported by the default content negotiation class. If you require it then you'll need to use a custom content negotiation class.
  • The custom HTTP_X_HTTP_METHOD_OVERRIDE header is no longer supported by default. If you require it then you'll need to use custom middleware.

The following pagination view attributes and settings have been moved into attributes on the pagination class since 3.1. Their usage was formerly deprecated, and has now been removed entirely, in line with the deprecation policy.

  • view.paginate_by - Use paginator.page_size instead.
  • view.page_query_param - Use paginator.page_query_param instead.
  • view.paginate_by_param - Use paginator.page_size_query_param instead.
  • view.max_paginate_by - Use paginator.max_page_size instead.
  • settings.PAGINATE_BY - Use paginator.page_size instead.
  • settings.PAGINATE_BY_PARAM - Use paginator.page_size_query_param instead.
  • settings.MAX_PAGINATE_BY - Use paginator.max_page_size instead.