summaryrefslogtreecommitdiff
path: root/docs/ref/django-admin.txt
diff options
context:
space:
mode:
authorSalvo Polizzi <salvopolizzi03@gmail.com>2025-02-14 08:17:25 +0100
committerSarah Boyce <42296566+sarahboyce@users.noreply.github.com>2025-07-17 12:51:43 +0200
commita5cd84ad2002f9a43363ab9fd9d9f6e9dfa48c60 (patch)
treee2307cc155727fe1ecd7042a215689ef1df507b5 /docs/ref/django-admin.txt
parent8499fba0e18826a77fe32cbc13a3d951d9ca8924 (diff)
Fixed #35680 -- Added automatic imports of common utilies to shell management command.
Diffstat (limited to 'docs/ref/django-admin.txt')
-rw-r--r--docs/ref/django-admin.txt17
1 files changed, 14 insertions, 3 deletions
diff --git a/docs/ref/django-admin.txt b/docs/ref/django-admin.txt
index a1603c9e84..22a7c0a10c 100644
--- a/docs/ref/django-admin.txt
+++ b/docs/ref/django-admin.txt
@@ -1067,9 +1067,15 @@ Starts the Python interactive interpreter.
All models from installed apps are automatically imported into the shell
environment. Models from apps listed earlier in :setting:`INSTALLED_APPS` take
-precedence. For a ``--verbosity`` of 2 or higher, the automatically imported
-objects will be listed. To disable automatic importing entirely, use the
-``--no-imports`` flag.
+precedence. The following common utilities are also imported::
+
+ from django.db import connection, reset_queries, models
+ from django.conf import settings
+ from django.utils import timezone
+
+For a ``--verbosity`` of 2 or higher, the automatically imported objects will
+be listed. To disable automatic importing entirely, use the ``--no-imports``
+flag.
See the guide on :ref:`customizing this behavior
<customizing-shell-auto-imports>` to add or remove automatic imports.
@@ -1078,6 +1084,11 @@ See the guide on :ref:`customizing this behavior
Automatic models import was added.
+.. versionchanged:: 6.0
+
+ Automatic imports of common utilities, such as ``django.conf.settings``,
+ were added.
+
.. django-admin-option:: --interface {ipython,bpython,python}, -i {ipython,bpython,python}
Specifies the shell to use. By default, Django will use IPython_ or bpython_ if