|Version 3 (modified by 7 years ago) (diff),|
Since version 1.0, Django has a policy of API stability. This means that, in general, code you develop against Django 1.0 should continue to work against later versions unchanged. However, we do sometimes make backwards-incompatible changes if they're necessary to resolve bugs.
Before upgrading to any version of Django, you should check all the notes for the version you are upgrading to and for any intermediate versions listed on this page. Changes that are in trunk and not yet in any released version are listed at the top of this page.
For changes made before version 1.0, see BackwardsIncompatibleChanges.
There have been large changes to the way that CSRF protection works, detailed in the CSRF documentaton, which has full upgrade notes. The following are the major changes that developers must be aware of:
CsrfMiddlewarehave been deprecated, and will be removed completely in Django 1.4, in favour of a template tag that should be inserted into forms.
- All contrib apps use a
csrf_protectdecorator to protect the view. This requires the use of the csrf_token template tag in the template, so if you have used custom templates for contrib views, (which includes things like a custom login template), you MUST READ THE UPGRADE INSTRUCTIONS to fix those templates.
CsrfViewMiddlewareis included in
MIDDLEWARE_CLASSESby default. This turns on CSRF protection by default, so that views that accept POST requests need to be written to work with the middleware. Instructions on how to do this are found in the CSRF docs.
- All of the CSRF code has moved from contrib to core (with backwards compatible imports in the old locations, which are deprecated).
LazyObject is an undocumented utility class used for lazily wrapping other
objects of unknown type. In Django 1.1 and earlier, it handled introspection in
a non-standard way, depending on wrapped objects implementing a public method
get_all_members(). Since this could easily lead to name clashes, it has been
changed to use the standard method, involving
If you used
LazyObject in your own code, and implemented the
get_all_members() method for wrapped objects, you need to make the following
- If your class does not have special requirements for introspection (i.e. you
have not implemented
__getattr__()or other methods that allow for attributes not discoverable by normal mechanisms), you can simply remove the
get_all_members()method. The default implementation on
LazyObjectwill do the right thing.
- If you have more complex requirements for introspection, first rename the
__dir__. This is the standard method, from Python 2.6 onwards, for supporting introspection. If you require support for Python < 2.6, add the following code to the class:
__members__ = property(lambda self: self.__dir__())