2013-07-01 19:53:06 +08:00
|
|
|
|
============================================
|
|
|
|
|
|
Django 1.7 release notes - UNDER DEVELOPMENT
|
|
|
|
|
|
============================================
|
|
|
|
|
|
|
|
|
|
|
|
Welcome to Django 1.7!
|
|
|
|
|
|
|
|
|
|
|
|
These release notes cover the `new features`_, as well as some `backwards
|
|
|
|
|
|
incompatible changes`_ you'll want to be aware of when upgrading from Django
|
|
|
|
|
|
1.6 or older versions. We've also dropped some features, which are detailed in
|
|
|
|
|
|
:doc:`our deprecation plan </internals/deprecation>`, and we've `begun the
|
|
|
|
|
|
deprecation process for some features`_.
|
|
|
|
|
|
|
|
|
|
|
|
.. _`new features`: `What's new in Django 1.7`_
|
|
|
|
|
|
.. _`backwards incompatible changes`: `Backwards incompatible changes in 1.7`_
|
|
|
|
|
|
.. _`begun the deprecation process for some features`: `Features deprecated in 1.7`_
|
|
|
|
|
|
|
2013-07-14 01:29:11 +08:00
|
|
|
|
Python compatibility
|
|
|
|
|
|
====================
|
|
|
|
|
|
|
|
|
|
|
|
Django 1.7 requires Python 2.7 or above, though we **highly recommend**
|
|
|
|
|
|
the latest minor release. Support for Python 2.6 has been dropped.
|
|
|
|
|
|
|
|
|
|
|
|
This change should affect only a small number of Django users, as most
|
|
|
|
|
|
operating-system vendors today are shipping Python 2.7 or newer as their default
|
|
|
|
|
|
version. If you're still using Python 2.6, however, you'll need to stick to
|
|
|
|
|
|
Django 1.6 until you can upgrade your Python version. Per :doc:`our support
|
|
|
|
|
|
policy </internals/release-process>`, Django 1.6 will continue to receive
|
|
|
|
|
|
security support until the release of Django 1.8.
|
|
|
|
|
|
|
2013-07-01 19:53:06 +08:00
|
|
|
|
What's new in Django 1.7
|
|
|
|
|
|
========================
|
|
|
|
|
|
|
2013-07-26 16:59:40 +08:00
|
|
|
|
Calling custom ``QuerySet`` methods from the ``Manager``
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
The :meth:`QuerySet.as_manager() <django.db.models.query.QuerySet.as_manager>`
|
|
|
|
|
|
class method has been added to :ref:`create Manager with QuerySet methods
|
|
|
|
|
|
<create-manager-with-queryset-methods>`.
|
|
|
|
|
|
|
2013-07-01 22:48:14 +08:00
|
|
|
|
Admin shortcuts support time zones
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
The "today" and "now" shortcuts next to date and time input widgets in the
|
|
|
|
|
|
admin are now operating in the :ref:`current time zone
|
|
|
|
|
|
<default-current-time-zone>`. Previously, they used the browser time zone,
|
|
|
|
|
|
which could result in saving the wrong value when it didn't match the current
|
|
|
|
|
|
time zone on the server.
|
|
|
|
|
|
|
|
|
|
|
|
In addition, the widgets now display a help message when the browser and
|
|
|
|
|
|
server time zone are different, to clarify how the value inserted in the field
|
|
|
|
|
|
will be interpreted.
|
|
|
|
|
|
|
2013-04-20 01:20:23 +08:00
|
|
|
|
Minor features
|
|
|
|
|
|
~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
* The new :attr:`UploadedFile.content_type_extra
|
|
|
|
|
|
<django.core.files.uploadedfile.UploadedFile.content_type_extra>` attribute
|
|
|
|
|
|
contains extra parameters passed to the ``content-type`` header on a file
|
|
|
|
|
|
upload.
|
|
|
|
|
|
|
2013-05-18 19:43:51 +08:00
|
|
|
|
* The ``enter`` argument was added to the
|
|
|
|
|
|
:data:`~django.test.signals.setting_changed` signal.
|
|
|
|
|
|
|
2013-05-18 19:49:06 +08:00
|
|
|
|
* The :meth:`QuerySet.update_or_create()
|
|
|
|
|
|
<django.db.models.query.QuerySet.update_or_create>` method was added.
|
|
|
|
|
|
|
2013-07-17 01:21:17 +08:00
|
|
|
|
* :attr:`~django.db.models.Options.app_label` is no longer required for models
|
|
|
|
|
|
that are defined in a ``models`` package within an app.
|
|
|
|
|
|
|
2013-07-16 19:11:32 +08:00
|
|
|
|
* The :meth:`Context.push() <django.template.Context.push>` method now returns
|
|
|
|
|
|
a context manager which automatically calls :meth:`pop()
|
|
|
|
|
|
<django.template.Context.pop>` upon exiting the ``with`` statement.
|
|
|
|
|
|
Additionally, :meth:`push() <django.template.Context.push>` now accepts
|
|
|
|
|
|
parameters that are passed to the ``dict`` constructor used to build the new
|
|
|
|
|
|
context level.
|
|
|
|
|
|
|
2013-07-18 03:20:20 +08:00
|
|
|
|
* The :class:`~django.utils.feedgenerator.Atom1Feed` syndication feed's
|
2013-08-15 19:14:10 +08:00
|
|
|
|
``updated`` element now utilizes ``updateddate`` instead of ``pubdate``,
|
2013-07-18 03:20:20 +08:00
|
|
|
|
allowing the ``published`` element to be included in the feed (which
|
|
|
|
|
|
relies on ``pubdate``).
|
|
|
|
|
|
|
2013-02-25 14:18:27 +08:00
|
|
|
|
* Buttons in :mod:`django.contrib.admin` now use the ``border-radius`` CSS
|
|
|
|
|
|
property for rounded corners rather than GIF background images.
|
|
|
|
|
|
|
2013-07-28 10:52:59 +08:00
|
|
|
|
* Some admin templates now have ``app-<app_name>`` and ``model-<model_name>``
|
|
|
|
|
|
classes in their ``<body>`` tag to allow customizing the CSS per app or per
|
|
|
|
|
|
model.
|
|
|
|
|
|
|
2013-07-28 10:50:02 +08:00
|
|
|
|
* The admin changelist cells now have a ``field-<field_name>`` class in the
|
|
|
|
|
|
HTML to enable style customizations.
|
|
|
|
|
|
|
2013-07-30 20:06:49 +08:00
|
|
|
|
* :func:`~django.core.mail.send_mail` now accepts an ``html_message``
|
|
|
|
|
|
parameter for sending a multipart ``text/plain`` and ``text/html`` email.
|
2013-07-28 23:11:04 +08:00
|
|
|
|
|
2013-02-23 23:28:45 +08:00
|
|
|
|
* The :djadminopt:`--no-color` option for ``django-admin.py`` allows you to
|
|
|
|
|
|
disable the colorization of management command output.
|
|
|
|
|
|
|
2013-07-23 22:25:21 +08:00
|
|
|
|
* The :mod:`sitemap framework<django.contrib.sitemaps>` now makes use of
|
|
|
|
|
|
:attr:`~django.contrib.sitemaps.Sitemap.lastmod` to set a ``Last-Modified``
|
|
|
|
|
|
header in the response. This makes it possible for the
|
|
|
|
|
|
:class:`~django.middleware.http.ConditionalGetMiddleware` to handle
|
|
|
|
|
|
conditional ``GET`` requests for sitemaps which set ``lastmod``.
|
|
|
|
|
|
|
2013-07-30 20:24:13 +08:00
|
|
|
|
* You can override the new :meth:`AuthenticationForm.confirm_login_allowed()
|
|
|
|
|
|
<django.contrib.auth.forms.AuthenticationForm.confirm_login_allowed>` method
|
|
|
|
|
|
to more easily customize the login policy.
|
|
|
|
|
|
|
2013-07-21 05:49:33 +08:00
|
|
|
|
* :attr:`Field.choices<django.db.models.Field.choices>` now allows you to
|
|
|
|
|
|
customize the "empty choice" label by including a tuple with an empty string
|
|
|
|
|
|
or ``None`` for the key and the custom label as the value. The default blank
|
|
|
|
|
|
option ``"----------"`` will be omitted in this case.
|
|
|
|
|
|
|
2013-08-04 00:15:15 +08:00
|
|
|
|
* The admin's search fields can now be customized per-request thanks to the new
|
|
|
|
|
|
:meth:`django.contrib.admin.ModelAdmin.get_search_fields` method.
|
|
|
|
|
|
|
2013-07-31 13:52:11 +08:00
|
|
|
|
* The :meth:`ModelAdmin.get_fields()
|
|
|
|
|
|
<django.contrib.admin.ModelAdmin.get_fields>` method may be overridden to
|
|
|
|
|
|
customize the value of :attr:`ModelAdmin.fields
|
|
|
|
|
|
<django.contrib.admin.ModelAdmin.fields>`.
|
|
|
|
|
|
|
2013-07-31 10:29:34 +08:00
|
|
|
|
* :func:`django.contrib.auth.views.password_reset` takes an optional
|
|
|
|
|
|
``html_email_template_name`` parameter used to send a multipart HTML email
|
|
|
|
|
|
for password resets.
|
|
|
|
|
|
|
2013-05-07 17:06:03 +08:00
|
|
|
|
* :class:`~django.forms.MultiValueField` allows optional subfields by setting
|
|
|
|
|
|
the ``require_all_fields`` argument to ``False``. The ``required`` attribute
|
|
|
|
|
|
for each individual field will be respected, and a new ``incomplete``
|
|
|
|
|
|
validation error will be raised when any required fields are empty.
|
|
|
|
|
|
|
2013-08-08 21:05:55 +08:00
|
|
|
|
* The :meth:`~django.forms.Form.clean` method on a form no longer needs to
|
|
|
|
|
|
return ``self.cleaned_data``. If it does return a changed dictionary then
|
2013-08-08 21:27:48 +08:00
|
|
|
|
that will still be used.
|
2013-08-08 21:05:55 +08:00
|
|
|
|
|
2013-08-01 23:31:34 +08:00
|
|
|
|
* The new :attr:`~django.db.models.Options.default_permissions` model
|
|
|
|
|
|
``Meta`` option allows you to customize (or disable) creation of the default
|
|
|
|
|
|
add, change, and delete permissions.
|
|
|
|
|
|
|
2013-08-08 00:03:31 +08:00
|
|
|
|
* The :func:`~django.contrib.auth.decorators.permission_required` decorator can
|
|
|
|
|
|
take a list of permissions as well as a single permission.
|
|
|
|
|
|
|
2013-05-13 19:38:53 +08:00
|
|
|
|
* The new :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS` setting controls
|
|
|
|
|
|
the file system permissions of directories created during file upload, like
|
|
|
|
|
|
:setting:`FILE_UPLOAD_PERMISSIONS` does for the files themselves.
|
|
|
|
|
|
|
2013-08-12 19:30:38 +08:00
|
|
|
|
* Explicit :class:`~django.db.models.OneToOneField` for
|
|
|
|
|
|
:ref:`multi-table-inheritance` are now discovered in abstract classes.
|
|
|
|
|
|
|
2013-06-05 04:41:49 +08:00
|
|
|
|
* The ``<label>`` and ``<input>`` tags rendered by
|
|
|
|
|
|
:class:`~django.forms.RadioSelect` and
|
|
|
|
|
|
:class:`~django.forms.CheckboxSelectMultiple` when looping over the radio
|
|
|
|
|
|
buttons or checkboxes now include ``for`` and ``id`` attributes, respectively.
|
|
|
|
|
|
Each radio button or checkbox includes an ``id_for_label`` attribute to
|
|
|
|
|
|
output the element's ID.
|
|
|
|
|
|
|
2013-08-10 16:13:41 +08:00
|
|
|
|
* Any ``**kwargs`` passed to
|
|
|
|
|
|
:meth:`~django.contrib.auth.models.User.email_user()` are passed to the
|
|
|
|
|
|
underlying :meth:`~django.core.mail.send_mail()` call.
|
|
|
|
|
|
|
2013-08-14 22:14:32 +08:00
|
|
|
|
* The :ttag:`widthratio` template tag now accepts an "as" parameter to capture
|
|
|
|
|
|
the result in a variable.
|
|
|
|
|
|
|
2013-07-01 19:53:06 +08:00
|
|
|
|
Backwards incompatible changes in 1.7
|
|
|
|
|
|
=====================================
|
|
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
|
|
|
|
|
In addition to the changes outlined in this section, be sure to review the
|
|
|
|
|
|
:doc:`deprecation plan </internals/deprecation>` for any features that
|
|
|
|
|
|
have been removed. If you haven't updated your code within the
|
|
|
|
|
|
deprecation timeline for a given feature, its removal may appear as a
|
|
|
|
|
|
backwards incompatible change.
|
|
|
|
|
|
|
2013-04-20 01:20:23 +08:00
|
|
|
|
Miscellaneous
|
|
|
|
|
|
~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
* The :meth:`django.core.files.uploadhandler.FileUploadHandler.new_file()`
|
|
|
|
|
|
method is now passed an additional ``content_type_extra`` parameter. If you
|
|
|
|
|
|
have a custom :class:`~django.core.files.uploadhandler.FileUploadHandler`
|
|
|
|
|
|
that implements ``new_file()``, be sure it accepts this new parameter.
|
|
|
|
|
|
|
2013-08-06 00:23:26 +08:00
|
|
|
|
* :class:`ModelFormSet<django.forms.models.BaseModelFormSet>`’s no longer
|
2013-07-12 21:52:18 +08:00
|
|
|
|
delete instances when ``save(commit=False)`` is called. See
|
|
|
|
|
|
:attr:`~django.forms.formsets.BaseFormSet.can_delete` for instructions on how
|
|
|
|
|
|
to manually delete objects from deleted forms.
|
|
|
|
|
|
|
2013-02-24 03:34:59 +08:00
|
|
|
|
* Loading empty fixtures emits a ``RuntimeWarning`` rather than raising
|
|
|
|
|
|
:class:`~django.core.management.CommandError`.
|
|
|
|
|
|
|
2013-07-31 19:22:38 +08:00
|
|
|
|
* :func:`django.contrib.staticfiles.views.serve` will now raise an
|
2013-07-31 15:11:49 +08:00
|
|
|
|
:exc:`~django.http.Http404` exception instead of
|
2013-07-31 19:22:38 +08:00
|
|
|
|
:exc:`~django.core.exceptions.ImproperlyConfigured` when :setting:`DEBUG`
|
|
|
|
|
|
is ``False``. This change removes the need to conditionally add the view to
|
2013-07-31 15:11:49 +08:00
|
|
|
|
your root URLconf, which in turn makes it safe to reverse by name. It also
|
|
|
|
|
|
removes the ability for visitors to generate spurious HTTP 500 errors by
|
|
|
|
|
|
requesting static files that don't exist or haven't been collected yet.
|
|
|
|
|
|
|
2013-08-07 14:51:32 +08:00
|
|
|
|
* The :meth:`django.db.models.Model.__eq__` method is now defined in a
|
|
|
|
|
|
way where instances of a proxy model and its base model are considered
|
|
|
|
|
|
equal when primary keys match. Previously only instances of exact same
|
|
|
|
|
|
class were considered equal on primary key match.
|
|
|
|
|
|
|
2013-07-01 19:53:06 +08:00
|
|
|
|
Features deprecated in 1.7
|
|
|
|
|
|
==========================
|
|
|
|
|
|
|
2013-07-29 21:50:58 +08:00
|
|
|
|
``django.utils.dictconfig``/``django.utils.importlib``
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
2013-07-02 04:50:58 +08:00
|
|
|
|
|
2013-07-29 21:50:58 +08:00
|
|
|
|
``django.utils.dictconfig`` and ``django.utils.importlib`` were copies of
|
|
|
|
|
|
respectively :mod:`logging.config` and :mod:`importlib` provided for Python
|
|
|
|
|
|
versions prior to 2.7. They have been deprecated.
|
2013-07-02 04:50:58 +08:00
|
|
|
|
|
2013-07-01 19:53:06 +08:00
|
|
|
|
``django.utils.unittest``
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
``django.utils.unittest`` provided uniform access to the ``unittest2`` library
|
|
|
|
|
|
on all Python versions. Since ``unittest2`` became the standard library's
|
|
|
|
|
|
:mod:`unittest` module in Python 2.7, and Django 1.7 drops support for older
|
|
|
|
|
|
Python versions, this module isn't useful anymore. It has been deprecated. Use
|
|
|
|
|
|
:mod:`unittest` instead.
|
2013-07-16 21:10:04 +08:00
|
|
|
|
|
2013-08-03 13:41:15 +08:00
|
|
|
|
``django.utils.datastructures.SortedDict``
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
As :class:`~collections.OrderedDict` was added to the standard library in
|
|
|
|
|
|
Python 2.7, :class:`~django.utils.datastructures.SortedDict` is no longer
|
|
|
|
|
|
needed and has been deprecated.
|
|
|
|
|
|
|
2013-07-16 21:10:04 +08:00
|
|
|
|
Custom SQL location for models package
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
Previously, if models were organized in a package (``myapp/models/``) rather
|
|
|
|
|
|
than simply ``myapp/models.py``, Django would look for :ref:`initial SQL data
|
|
|
|
|
|
<initial-sql>` in ``myapp/models/sql/``. This bug has been fixed so that Django
|
|
|
|
|
|
will search ``myapp/sql/`` as documented. The old location will continue to
|
|
|
|
|
|
work until Django 1.9.
|
2013-07-31 13:52:11 +08:00
|
|
|
|
|
|
|
|
|
|
``declared_fieldsets`` attribute on ``ModelAdmin.``
|
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
|
|
``ModelAdmin.declared_fieldsets`` was deprecated. Despite being a private API,
|
|
|
|
|
|
it will go through a regular deprecation path. This attribute was mostly used
|
|
|
|
|
|
by methods that bypassed ``ModelAdmin.get_fieldsets()`` but this was considered
|
|
|
|
|
|
a bug and has been addressed.
|
