Debian Codegraph @

docs/releases/3.1.1.txt

raw
1 ==========================
2 Django 3.1.1 release notes
3 ==========================
4
5 *September 1, 2020*
6
7 Django 3.1.1 fixes two security issues and several bugs in 3.1.
8
9 CVE-2020-24583: Incorrect permissions on intermediate-level directories on Python 3.7+
10 ======================================================================================
11
12 On Python 3.7+, :setting:`FILE_UPLOAD_DIRECTORY_PERMISSIONS` mode was not
13 applied to intermediate-level directories created in the process of uploading
14 files and to intermediate-level collected static directories when using the
15 :djadmin:`collectstatic` management command.
16
17 You should review and manually fix permissions on existing intermediate-level
18 directories.
19
20 CVE-2020-24584: Permission escalation in intermediate-level directories of the file system cache on Python 3.7+
21 ===============================================================================================================
22
23 On Python 3.7+, the intermediate-level directories of the file system cache had
24 the system's standard umask rather than ``0o077`` (no group or others
25 permissions).
26
27 Bugfixes
28 ========
29
30 * Fixed wrapping of translated action labels in the admin's navigation sidebar
31 for East Asian languages (:ticket:`31853`).
32
33 * Fixed wrapping of long model names in the admin's navigation sidebar
34 (:ticket:`31854`).
35
36 * Fixed encoding session data while upgrading multiple instances of the same
37 project to Django 3.1 (:ticket:`31864`).
38
39 * Adjusted admin's navigation sidebar template to reduce debug logging when
40 rendering (:ticket:`31865`).
41
42 * Fixed a data loss possibility in the
43 :meth:`~django.db.models.query.QuerySet.select_for_update()`. When using
44 related fields pointing to a proxy model in the ``of`` argument, the
45 corresponding model was not locked (:ticket:`31866`).
46
47 * Fixed a data loss possibility, following a regression in Django 2.0, when
48 copying model instances with a cached fields value (:ticket:`31863`).
49
50 * Fixed a regression in Django 3.1 that caused a crash when decoding an invalid
51 session data (:ticket:`31895`).
52
53 * Reverted a deprecation in Django 3.1 that caused a crash when passing
54 deprecated keyword arguments to a queryset in
55 ``TemplateView.get_context_data()`` (:ticket:`31877`).
56
57 * Enforced thread sensitivity of the :class:`MiddlewareMixin.process_request()
58 <django.utils.deprecation.MiddlewareMixin>` and ``process_response()`` hooks
59 when in an async context (:ticket:`31905`).
60
61 * Fixed ``__in`` lookup on key transforms for
62 :class:`~django.db.models.JSONField` with MariaDB, MySQL, Oracle, and SQLite
63 (:ticket:`31936`).
64
65 * Fixed a regression in Django 3.1 that caused permission errors in
66 ``CommonPasswordValidator`` and ``settings.py`` generated by the
67 :djadmin:`startproject` command, when user didn't have permissions to all
68 intermediate directories in a Django installation path (:ticket:`31912`).
69
70 * Fixed detecting an async ``get_response`` callable in various builtin
71 middlewares (:ticket:`31928`).
72
73 * Fixed a ``QuerySet.order_by()`` crash on PostgreSQL when ordering and
74 grouping by :class:`~django.db.models.JSONField` with a custom
75 :attr:`~django.db.models.JSONField.decoder` (:ticket:`31956`). As a
76 consequence, fetching a ``JSONField`` with raw SQL now returns a string
77 instead of preloaded data. You will need to explicitly call ``json.loads()``
78 in such cases.
79
80 * Fixed a ``QuerySet.delete()`` crash on MySQL, following a performance
81 regression in Django 3.1 on MariaDB 10.3.2+, when filtering against an
82 aggregate function (:ticket:`31965`).
83
84 * Fixed a ``django.contrib.admin.EmptyFieldListFilter`` crash when using on
85 reverse relations (:ticket:`31952`).
86
87 * Prevented content overflowing in the admin changelist view when the
88 navigation sidebar is enabled (:ticket:`31901`).