django-types 0.20.0__py3-none-any.whl → 0.22.0__py3-none-any.whl

django-stubs/core/mail/__init__.pyi

@@ -25,7 +25,7 @@ def send_mail(
     html_message: str | None = ...,
 ) -> int: ...
 def send_mass_mail(
-    datatuple: list[tuple[str, str, str, list[str]]],
+    datatuple: list[tuple[str, str, str | None, list[str]]],
     fail_silently: bool = ...,
     auth_user: str | None = ...,
     auth_password: str | None = ...,

django-stubs/core/mail/backends/base.pyi

@@ -6,6 +6,7 @@ from typing_extensions import Self
 from django.core.mail.message import EmailMessage
 
 class BaseEmailBackend:
+    fail_silently: bool
     def __init__(self, fail_silently: bool = ..., **kwargs: Any) -> None: ...
     def open(self) -> bool | None: ...
     def close(self) -> None: ...

django-stubs/db/backends/utils.pyi

@@ -2,8 +2,7 @@ import types
 from collections.abc import Iterable, Iterator, Mapping, Sequence
 from datetime import date, datetime, time
 from decimal import Decimal
-from typing import IO, Any
-from typing_extensions import Literal
+from typing import IO, Any, Literal
 from uuid import UUID
 
 import psycopg2.extensions

django-stubs/db/migrations/operations/base.pyi

@@ -1,25 +1,50 @@
+import enum
+from collections.abc import Sequence
 from typing import Any
+from typing_extensions import Self
+
+from django.db.backends.base.schema import BaseDatabaseSchemaEditor
+from django.db.migrations.state import ProjectState
+from django.db.models import Model
+
+class OperationCategory(str, enum.Enum):
+    ADDITION = "+"
+    REMOVAL = "-"
+    ALTERATION = "~"
+    PYTHON = "p"
+    SQL = "s"
+    MIXED = "?"
 
 class Operation:
-    reversible: bool = ...
-    reduces_to_sql: bool = ...
-    atomic: bool = ...
-    elidable: bool = ...
-    serialization_expand_args: Any = ...
-    def deconstruct(self) -> Any: ...
-    def state_forwards(self, app_label: Any, state: Any) -> None: ...
+    reversible: bool
+    reduces_to_sql: bool
+    atomic: bool
+    elidable: bool
+    serialization_expand_args: list[Any]
+    category: OperationCategory | None
+    def __new__(cls, *args: Any, **kwargs: Any) -> Self: ...
+    def deconstruct(self) -> tuple[str, Sequence[Any], dict[str, Any]]: ...
+    def state_forwards(self, app_label: str, state: ProjectState) -> None: ...
     def database_forwards(
-        self, app_label: Any, schema_editor: Any, from_state: Any, to_state: Any
+        self,
+        app_label: str,
+        schema_editor: BaseDatabaseSchemaEditor,
+        from_state: ProjectState,
+        to_state: ProjectState,
     ) -> None: ...
     def database_backwards(
-        self, app_label: Any, schema_editor: Any, from_state: Any, to_state: Any
+        self,
+        app_label: str,
+        schema_editor: BaseDatabaseSchemaEditor,
+        from_state: ProjectState,
+        to_state: ProjectState,
     ) -> None: ...
     def describe(self) -> str: ...
-    def references_model(self, name: str, app_label: str = ...) -> bool: ...
-    def references_field(
-        self, model_name: str, name: str, app_label: str = ...
-    ) -> bool: ...
-    def allow_migrate_model(self, connection_alias: Any, model: Any) -> bool: ...
+    def references_model(self, name: str, app_label: str) -> bool: ...
+    def references_field(self, model_name: str, name: str, app_label: str) -> bool: ...
+    def allow_migrate_model(
+        self, connection_alias: str, model: type[Model]
+    ) -> bool | None: ...
     def reduce(
-        self, operation: Operation, in_between: list[Operation], app_label: str = ...
-    ) -> bool: ...
+        self, operation: Operation, app_label: str
+    ) -> list[Operation] | bool: ...

django-stubs/db/models/__init__.pyi

@@ -92,6 +92,7 @@ from .fields.related import ManyToManyRel as ManyToManyRel
 from .fields.related import ManyToOneRel as ManyToOneRel
 from .fields.related import OneToOneField as OneToOneField
 from .fields.related import OneToOneRel as OneToOneRel
+from .fields.composite import CompositePrimaryKey as CompositePrimaryKey
 from .indexes import Index as Index
 from .lookups import Lookup as Lookup
 from .lookups import Transform as Transform

django-stubs/db/models/base.pyi

@@ -9,6 +9,7 @@ from django.core.exceptions import (
 from django.core.exceptions import ObjectDoesNotExist, ValidationError
 from django.db.models.manager import BaseManager
 from django.db.models.options import Options
+from django.db.models.query import QuerySet
 
 class ModelStateFieldsCacheDescriptor: ...
 
@@ -79,10 +80,16 @@ class Model(metaclass=ModelBase):
         update_fields: Iterable[str] | None = ...,
     ) -> Any: ...
     def refresh_from_db(
-        self, using: str | None = ..., fields: list[str] | None = ...
+        self,
+        using: str | None = ...,
+        fields: list[str] | None = ...,
+        from_queryset: QuerySet[Self] | None = ...,
     ) -> None: ...
     async def arefresh_from_db(
-        self, using: str | None = ..., fields: list[str] | None = ...
+        self,
+        using: str | None = ...,
+        fields: list[str] | None = ...,
+        from_queryset: QuerySet[Self] | None = ...,
     ) -> None: ...
     def get_deferred_fields(self) -> set[str]: ...
     @classmethod

django-stubs/db/models/enums.pyi

@@ -1,5 +1,6 @@
 import enum
-from typing import Any, Sequence, TypeVar
+from collections.abc import Sequence
+from typing import Any, TypeVar
 
 _EnumMemberT = TypeVar("_EnumMemberT")
 

django-stubs/db/models/fields/__init__.pyi

@@ -1,10 +1,10 @@
 import decimal
 import ipaddress
 import uuid
-from collections.abc import Callable, Iterable, Sequence
+from collections.abc import Callable, Iterable, Mapping, Sequence
 from datetime import date, datetime, time, timedelta
-from typing import Any, Generic, Mapping, TypeVar, overload
-from typing_extensions import Literal, Self
+from typing import Any, Generic, Literal, TypeVar, overload
+from typing_extensions import Self
 
 from django.core.checks import CheckMessage
 from django.core.exceptions import FieldDoesNotExist as FieldDoesNotExist

django-stubs/db/models/fields/composite.pyi

@@ -0,0 +1,74 @@
+from collections.abc import Iterable, Iterator, Mapping
+from typing import Any, Literal
+
+from django.contrib.contenttypes.fields import GenericForeignKey
+
+from django.db.models.fields import NOT_PROVIDED, Field
+from django.db.models.base import Model
+from django.db.models.fields.reverse_related import ForeignObjectRel
+from django.utils.functional import cached_property
+
+StrOrPromise = str
+from django.db.models.fields import Field, _ValidatorCallable, _LiteralFieldChoices
+
+class AttributeSetter:
+    def __init__(self, name: str, value: Any) -> None: ...
+
+class CompositeAttribute:
+    field: CompositePrimaryKey
+    def __init__(self, field: CompositePrimaryKey) -> None: ...
+    @property
+    def attnames(self) -> list[str]: ...
+    def __get__(
+        self, instance: Model, cls: type[Model] | None = None
+    ) -> tuple[Any, ...]: ...
+    def __set__(
+        self, instance: Model, values: list[Any] | tuple[Any] | None
+    ) -> None: ...
+
+class CompositePrimaryKey(Field[tuple[Any, ...] | None, tuple[Any, ...] | None]):
+    field_names: tuple[str]
+    descriptor_class: type[CompositeAttribute]
+    def __init__(
+        self,
+        *args: str,
+        verbose_name: StrOrPromise | None = None,
+        name: str | None = None,
+        primary_key: Literal[True] = True,
+        max_length: int | None = None,
+        unique: bool = False,
+        blank: Literal[True] = True,
+        null: bool = False,
+        db_index: bool = False,
+        rel: ForeignObjectRel | None = None,
+        default: type[NOT_PROVIDED] = ...,
+        editable: Literal[False] = False,
+        serialize: bool = True,
+        unique_for_date: str | None = None,
+        unique_for_month: str | None = None,
+        unique_for_year: str | None = None,
+        choices: _LiteralFieldChoices | None = None,
+        help_text: StrOrPromise = "",
+        db_column: None = None,
+        db_tablespace: str | None = None,
+        auto_created: bool = False,
+        validators: Iterable[_ValidatorCallable] = (),
+        error_messages: Mapping[str, StrOrPromise] | None = None,
+        db_comment: str | None = None,
+        db_default: type[NOT_PROVIDED] = ...,
+    ) -> None: ...
+    @cached_property
+    def fields(
+        self,
+    ) -> tuple[Field[Any, Any] | ForeignObjectRel | GenericForeignKey, ...]: ...
+    @cached_property
+    def columns(self) -> tuple[str, ...]: ...
+    def __iter__(
+        self,
+    ) -> Iterator[Field[Any, Any] | ForeignObjectRel | GenericForeignKey]: ...
+    def __len__(self) -> int: ...
+    def get_pk_value_on_save(
+        self, instance: Model
+    ) -> tuple[Any, ...] | None: ...  # actual type is tuple of field.value_from_object
+
+def unnest(fields: Iterable[Field[Any, Any]]) -> list[Field[Any, Any]]: ...

django-stubs/db/models/fields/json.pyi

@@ -1,7 +1,7 @@
 import json
 from collections.abc import Callable, Iterable
-from typing import Any, TypeVar, overload
-from typing_extensions import Literal, Self
+from typing import Any, Literal, TypeVar, overload
+from typing_extensions import Self
 
 from django.db.models import lookups
 from django.db.models.expressions import Combinable

django-stubs/db/models/fields/related.pyi

@@ -1,6 +1,6 @@
 from collections.abc import Callable, Iterable, Sequence
-from typing import Any, Generic, Protocol, TypeVar, overload
-from typing_extensions import Literal, Self
+from typing import Any, Generic, Literal, Protocol, TypeVar, overload
+from typing_extensions import Self
 from uuid import UUID
 
 from django.db import models

django-stubs/db/models/manager.pyi

@@ -1,5 +1,5 @@
-from collections.abc import Iterable, MutableMapping
-from typing import Any, Callable, Generic, TypeVar
+from collections.abc import Callable, Iterable, MutableMapping
+from typing import Any, Generic, TypeVar
 from typing_extensions import Self
 
 from django.db.models.base import Model

django-stubs/db/utils.pyi

@@ -1,7 +1,17 @@
-from collections.abc import Iterable
+from collections.abc import Callable, Iterable
+from types import TracebackType
 from typing import Any
+from typing import Any as Incomplete
+from typing import ParamSpec, TypeVar
 
-from django.db import DefaultConnectionProxy
+from django.apps import AppConfig
+from django.db.backends.base.base import BaseDatabaseWrapper
+from django.db.models import Model
+from django.utils.connection import BaseConnectionHandler
+from django.utils.connection import ConnectionDoesNotExist as ConnectionDoesNotExist
+
+_P = ParamSpec("_P")
+_R = TypeVar("_R")
 
 DEFAULT_DB_ALIAS: str
 DJANGO_VERSION_PICKLE_KEY: str
@@ -16,23 +26,38 @@ class InternalError(DatabaseError): ...
 class ProgrammingError(DatabaseError): ...
 class NotSupportedError(DatabaseError): ...
 
-def load_backend(backend_name: str) -> Any: ...
+class DatabaseErrorWrapper:
+    wrapper: Incomplete
+    def __init__(self, wrapper: Incomplete) -> None: ...
+    def __enter__(self) -> None: ...
+    def __exit__(
+        self,
+        exc_type: type[BaseException] | None,
+        exc_value: BaseException | None,
+        traceback: TracebackType | None,
+    ) -> None: ...
+    def __call__(self, func: Callable[_P, _R]) -> Callable[_P, _R]: ...
 
-class ConnectionDoesNotExist(Exception): ...
+def load_backend(backend_name: str) -> Any: ...
 
-class ConnectionHandler:
-    databases: dict[str, dict[str, Any | None]]
-    def __init__(self, databases: dict[str, dict[str, Any | None]] = ...) -> None: ...
-    def ensure_defaults(self, alias: str) -> None: ...
-    def prepare_test_settings(self, alias: str) -> None: ...
-    def __getitem__(self, alias: str) -> DefaultConnectionProxy: ...
-    def __setitem__(self, key: Any, value: Any) -> None: ...
-    def __delitem__(self, key: Any) -> None: ...
-    def __iter__(self) -> Any: ...
-    def all(self) -> list[Any]: ...
-    def close_all(self) -> None: ...
+class ConnectionHandler(BaseConnectionHandler):
+    settings_name: str  # pyright: ignore[reportIncompatibleVariableOverride]
+    def configure_settings(
+        self, databases: dict[str, dict[str, Any]] | None
+    ) -> dict[str, dict[str, Any]]: ...
+    @property
+    def databases(self) -> dict[str, dict[str, Any]]: ...
+    def create_connection(self, alias: str) -> BaseDatabaseWrapper: ...
 
 class ConnectionRouter:
-    def __init__(self, routers: Iterable[Any] | None = ...) -> None: ...
+    def __init__(self, routers: Iterable[Any] | None = None) -> None: ...
     @property
     def routers(self) -> list[Any]: ...
+    def db_for_read(self, model: type[Model], **hints: Any) -> str: ...
+    def db_for_write(self, model: type[Model], **hints: Any) -> str: ...
+    def allow_relation(self, obj1: Model, obj2: Model, **hints: Any) -> bool: ...
+    def allow_migrate(self, db: str, app_label: str, **hints: Any) -> bool: ...
+    def allow_migrate_model(self, db: str, model: type[Model]) -> bool: ...
+    def get_migratable_models(
+        self, app_config: AppConfig, db: str, include_auto_created: bool = False
+    ) -> list[type[Model]]: ...

django-stubs/forms/formsets.pyi

@@ -1,4 +1,4 @@
-from collections.abc import Iterator
+from collections.abc import Iterator, Mapping
 from typing import Any, Generic, TypeVar
 
 from django.forms import BaseForm, Form
@@ -34,18 +34,18 @@ class BaseFormSet(Generic[_BaseFormT], RenderableFormMixin):
     auto_id: str
     data: dict[str, Any]
     files: dict[str, Any]
-    initial: dict[str, Any] | None
+    initial: list[dict[str, Any]] | None
     form_kwargs: dict[str, Any]
     error_class: type[ErrorList]
     error_messages: dict[str, Any]
 
     def __init__(
         self,
-        data: dict[str, Any] | None = ...,
-        files: dict[str, Any] | None = ...,
+        data: Mapping[str, Any] | None = ...,
+        files: Mapping[str, Any] | None = ...,
         auto_id: str = ...,
         prefix: str | None = ...,
-        initial: dict[str, Any] | None = ...,
+        initial: list[dict[str, Any]] | None = ...,
         error_class: type[ErrorList] = ...,
         form_kwargs: dict[str, Any] | None = ...,
         error_messages: dict[str, Any] | None = ...,
@@ -109,7 +109,7 @@ class _FormSet(BaseFormSet[_BaseFormT]):
     renderer: BaseRenderer
 
 def formset_factory(
-    form: _BaseFormT,
+    form: type[_BaseFormT],
     formset: type[BaseFormSet[_BaseFormT]] = ...,
     extra: int = ...,
     can_order: bool = ...,

django-stubs/forms/models.pyi

@@ -7,8 +7,7 @@ from collections.abc import (
     Sequence,
 )
 from datetime import datetime
-from typing import Any, ClassVar, Protocol, TypeVar
-from typing_extensions import Literal
+from typing import Any, ClassVar, Literal, Protocol, TypeVar
 from unittest.mock import MagicMock
 from uuid import UUID
 
@@ -258,7 +257,7 @@ class ModelChoiceField(ChoiceField):
     empty_label: str | None = ...
     queryset: Any = ...
     limit_choices_to: dict[str, Any] | Callable[[], Any] | None = ...
-    to_field_name: None = ...
+    to_field_name: str | None = ...
     def __init__(
         self,
         queryset: Manager[Any] | QuerySet[Any] | None,
@@ -269,7 +268,7 @@ class ModelChoiceField(ChoiceField):
         label: Any | None = ...,
         initial: Any | None = ...,
         help_text: str = ...,
-        to_field_name: Any | None = ...,
+        to_field_name: str | None = ...,
         limit_choices_to: dict[str, Any] | Callable[[], Any] | None = ...,
         **kwargs: Any
     ) -> None: ...

django-stubs/http/request.pyi

@@ -3,8 +3,7 @@ from re import Pattern
 from typing import Any, BinaryIO, TypeVar, overload
 from typing_extensions import Self
 
-from django.contrib.auth.base_user import AbstractBaseUser
-from django.contrib.auth.models import AnonymousUser
+from django.contrib.auth.models import _AnyUser
 from django.contrib.sessions.backends.base import SessionBase
 from django.contrib.sites.models import Site
 from django.core.files import uploadedfile, uploadhandler
@@ -96,9 +95,14 @@ class HttpRequest:
     def __iter__(self) -> Iterable[bytes]: ...
     def readlines(self) -> list[bytes]: ...
 
-    # Attributes added by commonly-used middleware
-    user: AbstractBaseUser | AnonymousUser
+    # Attributes added by optional parts of Django
+    # django.contrib.admin views:
+    current_app: str
+    # django.contrib.auth.middleware.AuthenticationMiddleware:
+    user: _AnyUser
+    # django.contrib.sites.middleware.CurrentSiteMiddleware
     site: Site
+    # django.contrib.sessions.middleware.SessionMiddleware
     session: SessionBase
 
 class QueryDict(MultiValueDict[str, str]):

django-stubs/shortcuts.pyi

@@ -1,6 +1,5 @@
 from collections.abc import Callable, Mapping, Sequence
-from typing import Any, Protocol, TypeVar, overload
-from typing_extensions import Literal
+from typing import Any, Literal, Protocol, TypeVar, overload
 
 from django.db.models import Manager, QuerySet
 from django.db.models.base import Model

django-stubs/template/base.pyi

@@ -65,7 +65,7 @@ class Template:
     def __iter__(self) -> None: ...
     def render(
         self,
-        context: Context | dict[str, Any] | None = ...,
+        context: Context,
         request: HttpRequest | None = ...,
     ) -> SafeText: ...
     def compile_nodelist(self) -> NodeList: ...

django-stubs/template/context_processors.pyi

@@ -1,14 +1,13 @@
 from collections.abc import Callable
 from typing import Any
 
-from django.core.handlers.wsgi import WSGIRequest
 from django.http.request import HttpRequest
 from django.utils.functional import SimpleLazyObject
 
 def csrf(request: HttpRequest) -> dict[str, SimpleLazyObject]: ...
 def debug(request: HttpRequest) -> dict[str, Callable[..., Any] | bool]: ...
 def i18n(
-    request: WSGIRequest,
+    request: HttpRequest,
 ) -> dict[str, list[tuple[str, str]] | bool | str]: ...
 def tz(request: HttpRequest) -> dict[str, str]: ...
 def static(request: HttpRequest) -> dict[str, str]: ...

django-stubs/test/client.pyi

@@ -70,7 +70,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def post(
         self,
@@ -81,7 +81,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def head(
         self,
@@ -91,7 +91,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def trace(
         self,
@@ -100,7 +100,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def options(
         self,
@@ -111,7 +111,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def put(
         self,
@@ -122,7 +122,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def patch(
         self,
@@ -133,7 +133,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def delete(
         self,
@@ -144,7 +144,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
     def generic(
         self,
@@ -156,7 +156,7 @@ class RequestFactory:
         *,
         QUERY_STRING: str = ...,
         headers: Mapping[str, Any] | None = ...,
-        **extra: str,
+        **extra: object,
     ) -> WSGIRequest: ...
 
 class Client(RequestFactory):

django-stubs/test/testcases.pyi

@@ -148,13 +148,13 @@ class SimpleTestCase(unittest.TestCase):
     ) -> None: ...
     def assertJSONEqual(
         self,
-        raw: str,
+        raw: str | bytes | bytearray,
         expected_data: dict[str, Any] | list[Any] | str | int | float | bool | None,
         msg: str | None = ...,
     ) -> None: ...
     def assertJSONNotEqual(
         self,
-        raw: str,
+        raw: str | bytes | bytearray,
         expected_data: dict[str, Any] | list[Any] | str | int | float | bool | None,
         msg: str | None = ...,
     ) -> None: ...

django-stubs/urls/base.pyi

@@ -1,8 +1,21 @@
-from collections.abc import Callable, Sequence
-from typing import Any
+from collections.abc import Callable, Mapping, Sequence
+from typing import Any, TypeAlias
 
+from django.http.request import QueryDict
 from django.urls.resolvers import ResolverMatch
 
+# The values are passed through `str()` (unless they are bytes), so anything is valid.
+_QueryType: TypeAlias = (
+    Mapping[str, object]
+    | Mapping[bytes, object]
+    | Mapping[str | bytes, object]
+    | Mapping[str, Sequence[object]]
+    | Mapping[bytes, Sequence[object]]
+    | Mapping[str | bytes, Sequence[object]]
+    | Sequence[tuple[str | bytes, object]]
+    | Sequence[tuple[str | bytes, Sequence[object]]]
+)
+
 def resolve(path: str, urlconf: str | None = ...) -> ResolverMatch: ...
 def reverse(
     viewname: Callable[..., Any] | str | None,
@@ -10,6 +23,9 @@ def reverse(
     args: Sequence[Any] | None = ...,
     kwargs: dict[str, Any] | None = ...,
     current_app: str | None = ...,
+    *,
+    query: QueryDict | _QueryType | None = ...,
+    fragment: str | None = ...,
 ) -> str: ...
 
 reverse_lazy: Any

django-stubs/utils/cache.pyi

@@ -1,7 +1,7 @@
 from typing import Any
 
 from django.core.cache.backends.base import BaseCache
-from django.core.handlers.wsgi import WSGIRequest
+from django.http.request import HttpRequest
 from django.http.response import HttpResponse, HttpResponseBase
 
 cc_delim_re: Any
@@ -10,7 +10,7 @@ def patch_cache_control(response: HttpResponseBase, **kwargs: Any) -> None: ...
 def get_max_age(response: HttpResponse) -> int | None: ...
 def set_response_etag(response: HttpResponseBase) -> HttpResponseBase: ...
 def get_conditional_response(
-    request: WSGIRequest,
+    request: HttpRequest,
     etag: str | None = ...,
     last_modified: int | None = ...,
     response: HttpResponse | None = ...,
@@ -22,13 +22,13 @@ def add_never_cache_headers(response: HttpResponseBase) -> None: ...
 def patch_vary_headers(response: HttpResponseBase, newheaders: tuple[str]) -> None: ...
 def has_vary_header(response: HttpResponse, header_query: str) -> bool: ...
 def get_cache_key(
-    request: WSGIRequest,
+    request: HttpRequest,
     key_prefix: str | None = ...,
     method: str = ...,
     cache: BaseCache | None = ...,
 ) -> str | None: ...
 def learn_cache_key(
-    request: WSGIRequest,
+    request: HttpRequest,
     response: HttpResponse,
     cache_timeout: float | None = ...,
     key_prefix: str | None = ...,

django-stubs/utils/connection.pyi

@@ -0,0 +1,38 @@
+from abc import abstractmethod
+from collections.abc import Iterator
+from typing import Any
+
+from django.db.backends.base.base import BaseDatabaseWrapper
+from django.utils.functional import cached_property
+
+class ConnectionProxy:
+    """Proxy for accessing a connection object's attributes."""
+
+    def __init__(self, connections: BaseConnectionHandler, alias: str) -> None: ...
+    def __getattr__(self, item: str) -> Any: ...
+    def __setattr__(self, name: str, value: Any) -> None: ...
+    def __delattr__(self, name: str) -> None: ...
+    def __contains__(self, key: str) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
+
+class ConnectionDoesNotExist(Exception): ...
+
+class BaseConnectionHandler:
+    settings_name: str | None
+    exception_class: type[Exception]
+    thread_critical: bool
+
+    def __init__(self, settings: dict[str, dict[str, Any]] | None = None) -> None: ...
+    @cached_property
+    def settings(self) -> dict[str, dict[str, Any]]: ...
+    def configure_settings(
+        self, settings: dict[str, dict[str, Any]] | None
+    ) -> dict[str, dict[str, Any]]: ...
+    @abstractmethod
+    def create_connection(self, alias: str) -> BaseDatabaseWrapper: ...
+    def __getitem__(self, alias: str) -> BaseDatabaseWrapper: ...
+    def __setitem__(self, key: str, value: BaseDatabaseWrapper) -> None: ...
+    def __delitem__(self, key: str) -> None: ...
+    def __iter__(self) -> Iterator[str]: ...
+    def all(self, initialized_only: bool = False) -> list[BaseDatabaseWrapper]: ...
+    def close_all(self) -> None: ...