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

django-stubs/template/backends/django.pyi

@@ -1,8 +1,12 @@
-from collections.abc import Iterator
-from typing import Any
+from collections.abc import Iterator, Mapping
+from typing import Any, NoReturn
+from typing_extensions import override
 
+from django.http.request import HttpRequest
+from django.template import base
 from django.template.engine import Engine
 from django.template.exceptions import TemplateDoesNotExist
+from django.utils.safestring import SafeText
 
 from .base import BaseEngine
 
@@ -12,10 +16,27 @@ class DjangoTemplates(BaseEngine):
     def get_templatetag_libraries(
         self, custom_libraries: dict[str, str]
     ) -> dict[str, str]: ...
+    @override
+    def from_string(self, template_code: str) -> Template: ...
+    @override
+    def get_template(self, template_name: str) -> Template: ...
+
+class Template:
+    template: base.Template
+    backend: DjangoTemplates
+    def __init__(self, template: base.Template, backend: DjangoTemplates) -> None: ...
+    @property
+    def origin(self) -> base.Origin: ...
+    def render(
+        self,
+        context: Mapping[str, Any] | None = ...,
+        request: HttpRequest | None = ...,
+    ) -> SafeText: ...
 
 def copy_exception(
     exc: TemplateDoesNotExist, backend: DjangoTemplates | None = ...
 ) -> TemplateDoesNotExist: ...
-def reraise(exc: TemplateDoesNotExist, backend: DjangoTemplates) -> Any: ...
+def reraise(exc: TemplateDoesNotExist, backend: DjangoTemplates) -> NoReturn: ...
+def get_template_tag_modules() -> Iterator[tuple[str, str]]: ...
 def get_installed_libraries() -> dict[str, str]: ...
 def get_package_libraries(pkg: Any) -> Iterator[str]: ...

django-stubs/template/backends/dummy.pyi

@@ -1,20 +1,21 @@
 import string
+from collections.abc import Mapping
 from typing import Any
+from typing_extensions import override
 
 from django.http.request import HttpRequest
 
 from .base import BaseEngine
 
 class TemplateStrings(BaseEngine):
-    template_dirs: tuple[str]
-    def __init__(
-        self, params: dict[str, dict[Any, Any] | list[Any] | bool | str]
-    ) -> None: ...
+    @override
+    def from_string(self, template_code: str) -> Template: ...
+    @override
+    def get_template(self, template_name: str) -> Template: ...
 
 class Template(string.Template):
-    template: str
     def render(
         self,
-        context: dict[str, str] | None = ...,
+        context: Mapping[str, Any] | None = ...,
         request: HttpRequest | None = ...,
     ) -> str: ...

django-stubs/template/backends/jinja2.pyi

@@ -1,16 +1,34 @@
-from collections.abc import Callable
+from collections.abc import Callable, Mapping
 from typing import Any
+from typing_extensions import override
 
+from django.http.request import HttpRequest
+from django.template import base
 from django.template.exceptions import TemplateSyntaxError
+from django.utils.safestring import SafeText
 
 from .base import BaseEngine
 
 class Jinja2(BaseEngine):
     context_processors: list[str] = ...
-    def __init__(self, params: dict[str, Any]) -> None: ...
+    @override
+    def from_string(self, template_code: str) -> Template: ...
+    @override
+    def get_template(self, template_name: str) -> Template: ...
     @property
     def template_context_processors(self) -> list[Callable[..., Any]]: ...
 
+class Template:
+    template: base.Template
+    backend: Jinja2
+    origin: Origin
+    def __init__(self, template: base.Template, backend: Jinja2) -> None: ...
+    def render(
+        self,
+        context: Mapping[str, Any] | None = ...,
+        request: HttpRequest | None = ...,
+    ) -> SafeText: ...
+
 class Origin:
     name: str = ...
     template_name: str | None = ...

django-stubs/template/backends/utils.pyi

@@ -1,9 +1,9 @@
-from typing import Any
+from collections.abc import Callable
 
 from django.http.request import HttpRequest
 from django.utils.safestring import SafeText
 
 def csrf_input(request: HttpRequest) -> SafeText: ...
 
-csrf_input_lazy: Any
-csrf_token_lazy: Any
+csrf_input_lazy: Callable[[HttpRequest], SafeText]
+csrf_token_lazy: Callable[[HttpRequest], SafeText]

django-stubs/template/base.pyi

@@ -67,7 +67,7 @@ class Template:
         self,
         context: Context | dict[str, Any] | None = ...,
         request: HttpRequest | None = ...,
-    ) -> Any: ...
+    ) -> SafeText: ...
     def compile_nodelist(self) -> NodeList: ...
     def get_exception_info(
         self, exception: Exception, token: Token

django-stubs/template/context.pyi

@@ -68,8 +68,8 @@ class RequestContext(Context):
     dicts: list[dict[str, str]]
     render_context: RenderContext
     template_name: str | None
-    use_l10n: None
-    use_tz: None
+    use_l10n: None  # pyright: ignore[reportIncompatibleVariableOverride]
+    use_tz: None  # pyright: ignore[reportIncompatibleVariableOverride]
     request: HttpRequest = ...
     def __init__(
         self,

django-stubs/template/library.pyi

@@ -1,5 +1,6 @@
 from collections.abc import Callable
-from typing import Any
+from typing import Any, TypeVar, overload
+from typing_extensions import ParamSpec
 
 from django.template.base import FilterExpression, Origin, Parser, Token
 from django.template.context import Context
@@ -7,40 +8,103 @@ from django.utils.safestring import SafeText
 
 from .base import Node, Template
 
+T = TypeVar("T")
+P = ParamSpec("P")
+
 class InvalidTemplateLibrary(Exception): ...
 
 class Library:
     filters: dict[str, Callable[..., Any]] = ...
     tags: dict[str, Callable[..., Any]] = ...
     def __init__(self) -> None: ...
+
+    # Both arguments None
+    @overload
+    def tag(
+        self,
+        name: None = ...,
+        compile_function: None = ...,
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+    # Only name as function
+    @overload
+    def tag(
+        self,
+        name: Callable[P, T],
+        compile_function: None = ...,
+    ) -> Callable[P, T]: ...
+    # Only name as string
+    @overload
     def tag(
         self,
-        name: Callable[..., Any] | str | None = ...,
-        compile_function: Callable[..., Any] | str | None = ...,
-    ) -> Callable[..., Any]: ...
-    def tag_function(self, func: Callable[..., Any]) -> Callable[..., Any]: ...
+        name: str,
+        compile_function: None = ...,
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+    # Both arguments specified
+    @overload
+    def tag(
+        self,
+        name: str,
+        compile_function: Callable[P, T],
+    ) -> Callable[P, T]: ...
+    def tag_function(self, func: Callable[P, T]) -> Callable[P, T]: ...
+
+    # Both arguments None
+    @overload
+    def filter(
+        self,
+        name: None = ...,
+        filter_func: None = ...,
+        **flags: Any,
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+    # Only name as string
+    @overload
     def filter(
         self,
-        name: Callable[..., Any] | str | None = ...,
-        filter_func: Callable[..., Any] | str | None = ...,
-        **flags: Any
-    ) -> Callable[..., Any]: ...
-    def filter_function(
-        self, func: Callable[..., Any], **flags: Any
-    ) -> Callable[..., Any]: ...
+        name: str = ...,
+        filter_func: None = ...,
+        **flags: Any,
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+    # Only name as callable
+    @overload
+    def filter(
+        self,
+        name: Callable[P, T],
+        filter_func: None = ...,
+        **flags: Any,
+    ) -> Callable[P, T]: ...
+    # Both arguments
+    @overload
+    def filter(
+        self,
+        name: str,
+        filter_func: Callable[P, T],
+        **flags: Any,
+    ) -> Callable[P, T]: ...
+    def filter_function(self, func: Callable[P, T], **flags: Any) -> Callable[P, T]: ...
+
+    # func is None
+    @overload
+    def simple_tag(
+        self,
+        func: None = ...,
+        takes_context: bool | None = ...,
+        name: str | None = ...,
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
+    # func is callable
+    @overload
     def simple_tag(
         self,
-        func: Callable[..., Any] | str | None = ...,
+        func: Callable[P, T],
         takes_context: bool | None = ...,
         name: str | None = ...,
-    ) -> Callable[..., Any]: ...
+    ) -> Callable[P, T]: ...
     def inclusion_tag(
         self,
         filename: Template | str,
         func: None = ...,
         takes_context: bool | None = ...,
         name: str | None = ...,
-    ) -> Callable[..., Any]: ...
+    ) -> Callable[[Callable[P, T]], Callable[P, T]]: ...
 
 class TagHelperNode(Node):
     func: Any = ...

django-stubs/template/loader.pyi

@@ -1,19 +1,21 @@
 from typing import Any
 
 from django.http.request import HttpRequest
+from django.template.backends.base import _BaseTemplate
 from django.template.exceptions import (  # noqa: F401
     TemplateDoesNotExist as TemplateDoesNotExist,
 )
+from django.utils.safestring import SafeText
 
 from . import engines as engines  # noqa: F401
 
-def get_template(template_name: str, using: str | None = ...) -> Any: ...
+def get_template(template_name: str, using: str | None = ...) -> _BaseTemplate: ...
 def select_template(
     template_name_list: list[str] | str, using: str | None = ...
-) -> Any: ...
+) -> _BaseTemplate: ...
 def render_to_string(
     template_name: list[str] | str,
     context: dict[str, Any] | None = ...,
     request: HttpRequest | None = ...,
     using: str | None = ...,
-) -> str: ...
+) -> SafeText: ...

django-stubs/template/response.pyi

@@ -15,7 +15,7 @@ class ContentNotRenderedError(Exception): ...
 class SimpleTemplateResponse(HttpResponse):
     content: Any = ...
     closed: bool
-    cookies: SimpleCookie[Any]
+    cookies: SimpleCookie  # type: ignore [type-arg]
     status_code: int
     rendering_attrs: Any = ...
     template_name: list[str] | Template | str = ...
@@ -47,9 +47,9 @@ class SimpleTemplateResponse(HttpResponse):
 class TemplateResponse(SimpleTemplateResponse):
     client: Client
     closed: bool
-    context: RequestContext
+    context: RequestContext  # pyright: ignore[reportIncompatibleVariableOverride]
     context_data: dict[str, Any] | None
-    cookies: SimpleCookie[Any]
+    cookies: SimpleCookie  # type: ignore [type-arg]
     csrf_cookie_set: bool
     json: functools.partial[Any]
     redirect_chain: list[tuple[str, int]]

django-stubs/template/utils.pyi

@@ -1,4 +1,5 @@
-import collections
+from collections.abc import Iterator
+from pathlib import Path
 from typing import Any
 
 from django.core.exceptions import ImproperlyConfigured
@@ -7,10 +8,11 @@ from django.template.backends.base import BaseEngine
 class InvalidTemplateEngineError(ImproperlyConfigured): ...
 
 class EngineHandler:
-    templates: collections.OrderedDict[Any, Any]
     def __init__(self, templates: list[dict[str, Any]] = ...) -> None: ...
+    @property
+    def templates(self) -> dict[str, dict[str, Any]]: ...
     def __getitem__(self, alias: str) -> BaseEngine: ...
-    def __iter__(self) -> Any: ...
+    def __iter__(self) -> Iterator[BaseEngine]: ...
     def all(self) -> list[BaseEngine]: ...
 
-def get_app_template_dirs(dirname: str) -> tuple[Any, ...]: ...
+def get_app_template_dirs(dirname: str) -> tuple[Path, ...]: ...

django-stubs/test/client.pyi

@@ -1,3 +1,4 @@
+from collections.abc import Mapping
 from io import BytesIO
 from json import JSONEncoder
 from re import Pattern
@@ -36,6 +37,13 @@ class ClientHandler(BaseHandler):
     ) -> None: ...
     def __call__(self, environ: dict[str, Any]) -> HttpResponseBase: ...
 
+class AsyncClientHandler(BaseHandler):
+    enforce_csrf_checks: bool = ...
+    def __init__(
+        self, enforce_csrf_checks: bool = ..., *args: Any, **kwargs: Any
+    ) -> None: ...
+    async def __call__(self, scope: dict[str, Any]) -> HttpResponseBase: ...
+
 def encode_multipart(boundary: str, data: dict[str, Any]) -> bytes: ...
 def encode_file(boundary: str, key: str, file: Any) -> list[bytes]: ...
 
@@ -44,10 +52,14 @@ _RequestData = Any | None
 class RequestFactory:
     json_encoder: type[JSONEncoder]
     defaults: dict[str, str]
-    cookies: SimpleCookie[str]
+    cookies: SimpleCookie  # type: ignore [type-arg]
     errors: BytesIO
     def __init__(
-        self, *, json_encoder: type[JSONEncoder] = ..., **defaults: Any
+        self,
+        *,
+        json_encoder: type[JSONEncoder] = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **defaults: Any,
     ) -> None: ...
     def request(self, **request: Any) -> WSGIRequest: ...
     def get(
@@ -57,7 +69,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def post(
         self,
@@ -67,7 +80,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def head(
         self,
@@ -76,10 +90,17 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def trace(
-        self, path: str, secure: bool = ..., *, QUERY_STRING: str = ..., **extra: str
+        self,
+        path: str,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def options(
         self,
@@ -89,7 +110,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def put(
         self,
@@ -99,7 +121,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def patch(
         self,
@@ -109,7 +132,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def delete(
         self,
@@ -119,7 +143,8 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
     def generic(
         self,
@@ -130,20 +155,23 @@ class RequestFactory:
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> WSGIRequest: ...
 
 class Client(RequestFactory):
     handler: ClientHandler
     raise_request_exception: bool
     exc_info: tuple[type[BaseException], BaseException, TracebackType] | None
+    headers: dict[str, Any]
     def __init__(
         self,
         enforce_csrf_checks: bool = ...,
         raise_request_exception: bool = ...,
         *,
         json_encoder: type[JSONEncoder] = ...,
-        **defaults: Any
+        headers: Mapping[str, Any] | None = ...,
+        **defaults: Any,
     ) -> None: ...
     # Silence type warnings, since this class overrides arguments and return types in an unsafe manner.
     def request(self, **request: Any) -> HttpResponse: ...  # type: ignore [override]
@@ -155,7 +183,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def post(  # type: ignore [override]
         self,
@@ -166,7 +195,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def head(  # type: ignore [override]
         self,
@@ -176,7 +206,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def trace(  # type: ignore [override]
         self,
@@ -186,7 +217,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def options(  # type: ignore [override]
         self,
@@ -197,7 +229,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def put(  # type: ignore [override]
         self,
@@ -208,7 +241,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def patch(  # type: ignore [override]
         self,
@@ -219,7 +253,8 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def delete(  # type: ignore [override]
         self,
@@ -230,7 +265,128 @@ class Client(RequestFactory):
         secure: bool = ...,
         *,
         QUERY_STRING: str = ...,
-        **extra: str
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    def store_exc_info(self, **kwargs: Any) -> None: ...
+    @property
+    def session(self) -> SessionBase: ...
+    def login(self, **credentials: Any) -> bool: ...
+    def force_login(
+        self, user: AbstractBaseUser, backend: str | None = ...
+    ) -> None: ...
+    def logout(self) -> None: ...
+
+class AsyncRequestFactory(RequestFactory): ...
+
+class AsyncClient(AsyncRequestFactory):
+    handler: AsyncClientHandler
+    raise_request_exception: bool
+    exc_info: tuple[type[BaseException], BaseException, TracebackType] | None
+    headers: dict[str, Any]
+    def __init__(
+        self,
+        enforce_csrf_checks: bool = ...,
+        raise_request_exception: bool = ...,
+        *,
+        json_encoder: type[JSONEncoder] = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **defaults: Any,
+    ) -> None: ...
+    # Silence type warnings, since this class overrides arguments and return types in an unsafe manner.
+    async def request(self, **request: Any) -> HttpResponse: ...  # type: ignore [override]
+    async def get(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def post(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        content_type: str = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def head(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def trace(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def options(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        content_type: str = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def put(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        content_type: str = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def patch(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        content_type: str = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
+    ) -> HttpResponse: ...
+    async def delete(  # type: ignore [override]
+        self,
+        path: str,
+        data: _RequestData = ...,
+        content_type: str = ...,
+        follow: bool = ...,
+        secure: bool = ...,
+        *,
+        QUERY_STRING: str = ...,
+        headers: Mapping[str, Any] | None = ...,
+        **extra: str,
     ) -> HttpResponse: ...
     def store_exc_info(self, **kwargs: Any) -> None: ...
     @property