Release Notes
...
The Django 1.11.x series is the last to support Python 2. The next major release, Django 2.0, will only support Python 3.5+.
Deprecating warnings are no longer loud by default
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1350 |
|---|
|
¶Unlike older versions of Django, Django’s own deprecation warnings are no longer displayed by default. This is consistent with Python’s default behavior.
...
Also, the minimum supported version of psycopg2 is increased from 2.4.5 to 2.5.4.
LiveServerTestCase binds to port zero
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1367 |
|---|
|
¶Rather than taking a port range and iterating to find a free port, LiveServerTestCase binds to port zero and relies on the operating system to assign a free port. The DJANGO_LIVE_TEST_SERVER_ADDRESS environment variable is no longer used, and as it’s also no longer used, the manage.py test --liveserver option is removed.
If you need to bind LiveServerTestCase to a specific port, use the port attribute added in Django 1.11.2.
Protection against insecure redirects in django.contrib.auth and i18n views
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1369 |
|---|
|
¶LoginView, LogoutView (and the deprecated function-based equivalents), and set_language() protect users from being redirected to non-HTTPS next URLs when the app is running over HTTPS.
...
To prevent typos from passing silently, get_or_create() and update_or_create() check that their arguments are model fields. This should be backwards-incompatible only in the fact that it might expose a bug in your project.
pytz is a required dependency and support for settings.TIME_ZONE = None is removed
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1371 |
|---|
|
¶To simplify Django’s timezone handling, pytz is now a required dependency. It’s automatically installed along with Django.
...
from tzlocal import get_localzone
TIME_ZONE = get_localzone().zone
This works similar to settings.TIME_ZONE = None except that it also sets os.environ['TZ']. Let us know if there’s a use case where you find you can’t adapt your code to set a TIME_ZONE.
HTML changes in admin templates
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1372 |
|---|
|
¶<p class="help"> is replaced with a <div> tag to allow including lists inside help text.
Read-only fields are wrapped in <div class="readonly">...</div> instead of <p>...</p> to allow any kind of HTML as the field’s content.
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1373 |
|---|
|
¶Some undocumented classes in django.forms.widgets are removed:
...
Some widget values, such as <select> options, are now localized if settings.USE_L10N=True. You could revert to the old behavior with custom widget templates that uses the localize template tag to turn off localization.
django.template.backends.django.Template.render() prohibits non-dict context
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1376 |
|---|
|
¶For compatibility with multiple template engines, django.template.backends.django.Template.render() (returned from high-level template loader APIs such as loader.get_template()) must receive a dictionary of context rather than Context or RequestContext. If you were passing either of the two classes, pass a dictionary instead – doing so is backwards-compatible with older versions of Django.
Model state changes in migration operations
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1378 |
|---|
|
¶To improve the speed of applying migrations, rendering of related models is delayed until an operation that needs them (e.g. RunPython). If you have a custom operation that works with model classes or model instances from the from_state argument in database_forwards() or database_backwards(), you must render model states using the clear_delayed_apps_cache()method as described in writing your own migration operation.
...
Features deprecated in 1.11¶
models.permalink() decorator
| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1435 |
|---|
|
¶Use django.urls.reverse() instead. For example:
from django.db import models
class MyModel(models.Model):
...
@models.permalink
def url(self):
return ('guitarist_detail', [self.slug])
becomes:
from django.db import models
from django.urls import reverse
class MyModel(models.Model):
...
def url(self):
return reverse('guitarist_detail', args=[self.slug])
Miscellaneous¶
contrib.auth’s login() and logout() function-based views are deprecated| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1446 |
|---|
|
in favor of new class-based views LoginView andLogoutView.- The unused
extra_context parameter of contrib.auth.views.logout_then_login() is deprecated. contrib.auth’s password_change(), password_change_done(), password_reset(), password_reset_done(), password_reset_confirm(), and password_reset_complete() function-based views are deprecated| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1448 |
|---|
|
in favor of new class-based views PasswordChangeView, PasswordChangeDoneView, PasswordResetView, PasswordResetDoneView,PasswordResetConfirmView, and PasswordResetCompleteView.django.test.runner.setup_databases() is moved to django.test.| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1449 |
|---|
|
to django.test.utils.setup_databases(). The old location is deprecated.django.utils.translation.string_concat() is deprecated in favor of django.utils.text.format_lazy(). string_concat(*strings) can be replaced by format_lazy('{}' * len(strings), *strings).- For the
PyLibMCCache cache backend, passing pylibmc behavior settings as top-level attributes of OPTIONS is deprecated. Set them under a behaviors key within OPTIONS instead. - The
host parameter of django.utils.http.is_safe_url() is deprecated in favor of the new allowed_hosts parameter. - Silencing exceptions raised while rendering the
{% include %} template tag| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1453 |
|---|
|
is deprecated as the behavior is often more confusing than helpful. In Django 2.1, the exception will be raised. DatabaseIntrospection.get_indexes() is deprecated in favor of DatabaseIntrospection.get_constraints().authenticate() now passes a request argument to the authenticate() method of authentication backends. Support | Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1457 |
|---|
|
. Support for methods that don’t accept request as the first positional argument will be removed in Django 2.1.- The
USE_ETAGS setting| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1458 |
|---|
|
is deprecated in favor of ConditionalGetMiddleware which now adds the ETag header to responses regardless of the setting. CommonMiddleware and django.utils.cache.patch_response_headers() will no longer set ETags when the deprecation ends. Model._meta.has_auto_field is deprecated in favor of checking if Model._meta.auto_field is not None.- Using regular expression groups with
iLmsu# in url() is deprecated. The only group that’s useful is (?i) for case-insensitive URLs, however, case-insensitive URLs aren’t a good practice because they create multiple entries for search engines, for example. An alternative solution could be to create a handler404 that looks for uppercase characters in the URL and redirects to a lowercase equivalent. - The
renderer argument is added to the Widget.render() method.| Jira Legacy |
|---|
| showSummary | false |
|---|
| server | JIRA (openedx.atlassian.net) |
|---|
| serverId | 13fd1930-5608-3aac-a5dd-21b934d3a4b4 |
|---|
| key | PLAT-1463 |
|---|
|
Methods that don’t accept that argument will work through a deprecation period.