[pull] main from django:main

.github/workflows/benchmark.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Benchmark Repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           repository: django/django-asv
           path: "."
@@ -25,7 +25,7 @@ jobs:
       - name: Install Requirements
         run: pip install -r requirements.txt
       - name: Cache Django
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: Django/*
           key: Django

.github/workflows/check_commit_messages.yml

@@ -13,7 +13,7 @@ jobs:
     if: startsWith(github.event.pull_request.base.ref, 'stable/')
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Calculate commit prefix
         id: vars

.github/workflows/docs.yml

@@ -25,9 +25,9 @@ jobs:
     name: spelling
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'
@@ -43,9 +43,9 @@ jobs:
     name: blacken-docs
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - run: python -m pip install blacken-docs
@@ -64,9 +64,9 @@ jobs:
     name: lint-docs
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - run: python -m pip install sphinx-lint

.github/workflows/labels.yml

@@ -18,10 +18,10 @@ jobs:
     name: "Flag if no Trac ticket is found in the title"
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: "Check title and manage labels"
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const title = context.payload.pull_request.title;

.github/workflows/linters.yml

@@ -23,9 +23,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - run: python -m pip install flake8
@@ -40,9 +40,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - run: python -m pip install "isort<6"
@@ -57,6 +57,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: black
         uses: psf/black@stable

.github/workflows/new_contributor_pr.yml

@@ -12,7 +12,7 @@ jobs:
     name: Hello new contributor
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/first-interaction@v1
+      - uses: actions/first-interaction@v3
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           pr-message: |

.github/workflows/postgis.yml

@@ -38,9 +38,9 @@ jobs:
           --health-retries 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'

.github/workflows/python_matrix.yml

@@ -22,7 +22,7 @@ jobs:
       python_versions_output: ${{ steps.set-matrix.outputs.python_versions }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - id: set-matrix
         run: |
           python_versions=$(sed -n "s/^.*Programming Language :: Python :: \([[:digit:]]\+\.[[:digit:]]\+\).*$/'\1', /p" pyproject.toml | tr -d '\n' | sed 's/, $//g')
@@ -36,9 +36,9 @@ jobs:
         python-version: ${{ fromJson(needs.define-matrix.outputs.python_versions_output) }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'

.github/workflows/schedule_tests.yml

@@ -23,9 +23,9 @@ jobs:
     continue-on-error: true
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
@@ -41,9 +41,9 @@ jobs:
     name: Byte-compiled Django with no source files (only .pyc files)
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'
@@ -67,9 +67,9 @@ jobs:
     name: JavaScript tests
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '20'
           cache: 'npm'
@@ -82,9 +82,9 @@ jobs:
     name: Selenium tests, SQLite
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'
@@ -118,9 +118,9 @@ jobs:
           --health-retries 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'
@@ -163,9 +163,9 @@ jobs:
           --health-retries 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'

.github/workflows/schedules.yml

@@ -21,7 +21,7 @@ jobs:
         branch:
           - main
     steps:
-      - uses: actions/github-script@v7
+      - uses: actions/github-script@v8
         with:
           github-token: ${{secrets.SCHEDULE_WORKFLOW_TOKEN}}
           script: |

.github/workflows/screenshots.yml

@@ -20,9 +20,9 @@ jobs:
     name: Screenshots
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'

.github/workflows/selenium.yml

@@ -20,9 +20,9 @@ jobs:
     name: SQLite
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'
@@ -57,9 +57,9 @@ jobs:
           --health-retries 5
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: '3.13'
           cache: 'pip'

.github/workflows/tests.yml

@@ -27,9 +27,9 @@ jobs:
     name: Windows, SQLite, Python ${{ matrix.python-version }}
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: 'pip'
@@ -45,9 +45,9 @@ jobs:
     name: JavaScript tests
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
       - name: Set up Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '20'
           cache: 'npm'

django/template/base.py

@@ -52,13 +52,12 @@
 
 import inspect
 import logging
-import os
 import re
 import warnings
 from enum import Enum
 
-import django
 from django.template.context import BaseContext
+from django.utils.deprecation import django_file_prefixes
 from django.utils.formats import localize
 from django.utils.html import conditional_escape
 from django.utils.regex_helper import _lazy_re_compile
@@ -329,7 +328,7 @@ def source(self):
                 "PartialTemplate.source is only available when template "
                 "debugging is enabled.",
                 RuntimeWarning,
-                skip_file_prefixes=(os.path.dirname(django.__file__),),
+                skip_file_prefixes=django_file_prefixes(),
             )
         return self.find_partial_source(template.source)
 

django/utils/deprecation.py

@@ -9,6 +9,15 @@
 import django
 
 
+@functools.cache
+def django_file_prefixes():
+    try:
+        file = django.__file__
+    except AttributeError:
+        return ()
+    return (os.path.dirname(file),)
+
+
 class RemovedInDjango61Warning(DeprecationWarning):
     pass
 
@@ -237,7 +246,7 @@ def remap_deprecated_args(args, kwargs):
                 f"Passing positional argument(s) {remapped_names_str} to {func_name}() "
                 "is deprecated. Use keyword arguments instead.",
                 deprecation_warning,
-                skip_file_prefixes=(os.path.dirname(django.__file__),),
+                skip_file_prefixes=django_file_prefixes(),
             )
 
             return remaining_args, updated_kwargs

docs/internals/contributing/writing-code/submitting-patches.txt

@@ -282,7 +282,7 @@ previous behavior, or standalone items that are unnecessary or unused when the
 deprecation ends. For example::
 
     import warnings
-    from django.utils.deprecation import RemovedInDjangoXXWarning
+    from django.utils.deprecation import RemovedInDjangoXXWarning, django_file_prefixes
 
 
     # RemovedInDjangoXXWarning.
@@ -295,7 +295,7 @@ deprecation ends. For example::
         warnings.warn(
             "foo() is deprecated.",
             category=RemovedInDjangoXXWarning,
-            stacklevel=2,
+            stacklevel=django_file_prefixes(),
         )
         old_private_helper()
         ...

docs/ref/contrib/auth.txt

@@ -294,7 +294,7 @@ Methods
 
         Sends an email to the user. If ``from_email`` is ``None``, Django uses
         the :setting:`DEFAULT_FROM_EMAIL`. Any ``**kwargs`` are passed to the
-        underlying :meth:`~django.core.mail.send_mail` call.
+        underlying :func:`~django.core.mail.send_mail` call.
 
 Manager methods
 ---------------

docs/ref/django-admin.txt

@@ -1052,12 +1052,12 @@ together:
 .. django-admin-option:: --managers
 
 Mails the email addresses specified in :setting:`MANAGERS` using
-:meth:`~django.core.mail.mail_managers`.
+:func:`~django.core.mail.mail_managers`.
 
 .. django-admin-option:: --admins
 
 Mails the email addresses specified in :setting:`ADMINS` using
-:meth:`~django.core.mail.mail_admins`.
+:func:`~django.core.mail.mail_admins`.
 
 ``shell``
 ---------

docs/ref/settings.txt

@@ -2656,7 +2656,7 @@ protocol.
 .. admonition:: Why are my emails sent from a different address?
 
     This address is used only for error messages. It is *not* the address that
-    regular email messages sent with :meth:`~django.core.mail.send_mail`
+    regular email messages sent with :func:`~django.core.mail.send_mail`
     come from; for that, see :setting:`DEFAULT_FROM_EMAIL`.
 
 .. setting:: SHORT_DATE_FORMAT