django-rest-framework/docs/topics/release-notes.md

Release Notes

Release Early, Release Often

— Eric S. Raymond, The Cathedral and the Bazaar.

Master

• Added obtain_token_view to get tokens when using TokenAuthentication
• Bugfix: Django 1.5 configurable user support for TokenAuthentication

2.1.3

Date: 16th Nov 2012

• Added FileField and ImageField. For use with MultiPartParser.
• Added URLField and SlugField.
• Support for read_only_fields on ModelSerializer classes.
• Support for clients overriding the pagination page sizes. Use the PAGINATE_BY_PARAM setting or set the paginate_by_param attribute on a generic view.
• 201 Responses now return a 'Location' header.
• Bugfix: Serializer fields now respect max_length.

2.1.2

Date: 9th Nov 2012

• Filtering support.
• Bugfix: Support creation of objects with reverse M2M relations.

2.1.1

Date: 7th Nov 2012

• Support use of HTML exception templates. Eg. 403.html
• Hyperlinked fields take optional slug_field, slug_url_kwarg and pk_url_kwarg arguments.
• Bugfix: Deal with optional trailing slashs properly when generating breadcrumbs.
• Bugfix: Make textareas same width as other fields in browsable API.
• Private API change: .get_serializer now uses same instance and data ordering as serializer initialization.

2.1.0

Date: 5th Nov 2012

Warning: Please read this thread regarding the instance and data keyword args before updating to 2.1.0.

• Serializer instance and data keyword args have their position swapped.
• queryset argument is now optional on writable model fields.
• Hyperlinked related fields optionally take slug_field and slug_url_kwarg arguments.
• Support Django's cache framework.
• Minor field improvements. (Don't stringify dicts, more robust many-pk fields.)
• Bugfix: Support choice field in Browseable API.
• Bugfix: Related fields with read_only=True do not require a queryset argument.

2.0.2

Date: 2nd Nov 2012

• Fix issues with pk related fields in the browsable API.

2.0.1

Date: 1st Nov 2012

• Add support for relational fields in the browsable API.
• Added SlugRelatedField and ManySlugRelatedField.
• If PUT creates an instance return '201 Created', instead of '200 OK'.

2.0.0

Date: 30th Oct 2012

• Fix all of the things. (Well, almost.)
• For more information please see the 2.0 announcement.

---

0.4.0

• Supports Django 1.5.
• Fixes issues with 'HEAD' method.
• Allow views to specify template used by TemplateRenderer
• More consistent error responses
• Some serializer fixes
• Fix internet explorer ajax behaviour
• Minor xml and yaml fixes
• Improve setup (eg use staticfiles, not the defunct ADMIN_MEDIA_PREFIX)
• Sensible absolute URL generation, not using hacky set_script_prefix

0.3.3

• Added DjangoModelPermissions class to support django.contrib.auth style permissions.
• Use staticfiles for css files.
  • Easier to override. Won't conflict with customised admin styles (eg grappelli)
• Templates are now nicely namespaced.
  • Allows easier overriding.
• Drop implied 'pk' filter if last arg in urlconf is unnamed.
  • Too magical. Explict is better than implicit.
• Saner template variable autoescaping.
• Tider setup.py
• Updated for URLObject 2.0
• Bugfixes:
  • Bug with PerUserThrottling when user contains unicode chars.

0.3.2

• Bugfixes:
  • Fix 403 for POST and PUT from the UI with UserLoggedInAuthentication (#115)
  • serialize_model method in serializer.py may cause wrong value (#73)
  • Fix Error when clicking OPTIONS button (#146)
  • And many other fixes
• Remove short status codes
  • Zen of Python: "There should be one-- and preferably only one --obvious way to do it."
• get_name, get_description become methods on the view - makes them overridable.
• Improved model mixin API - Hooks for build_query, get_instance_data, get_model, get_queryset, get_ordering

0.3.1

• [not documented]

0.3.0

• JSONP Support
• Bugfixes, including support for latest markdown release

0.2.4

• Fix broken IsAdminUser permission.
• OPTIONS support.
• XMLParser.
• Drop mentions of Blog, BitBucket.

0.2.3

• Fix some throttling bugs.
• X-Throttle header on throttling.
• Support for nesting resources on related models.

0.2.2

• Throttling support complete.

0.2.1

• Couple of simple bugfixes over 0.2.0

0.2.0

• Big refactoring changes since 0.1.0, ask on the discussion group if anything isn't clear. The public API has been massively cleaned up. Expect it to be fairly stable from here on in.

• Resource becomes decoupled into View and Resource, your views should now inherit from View, not Resource.

• The handler functions on views .get() .put() .post() etc, no longer have the content and auth args. Use self.CONTENT inside a view to access the deserialized, validated content. Use self.user inside a view to access the authenticated user.

• allowed_methods and anon_allowed_methods are now defunct. if a method is defined, it's available. The permissions attribute on a View is now used to provide generic permissions checking. Use permission classes such as FullAnonAccess, IsAuthenticated or IsUserOrIsAnonReadOnly to set the permissions.

• The authenticators class becomes authentication. Class names change to Authentication.

• The emitters class becomes renderers. Class names change to Renderers.

• ResponseException becomes ErrorResponse.

• The mixin classes have been nicely refactored, the basic mixins are now RequestMixin, ResponseMixin, AuthMixin, and ResourceMixin You can reuse these mixin classes individually without using the View class.

0.1.1

• Final build before pulling in all the refactoring changes for 0.2, in case anyone needs to hang on to 0.1.

0.1.0

• Initial release.