basedpyright 1.1.389 → 1.1.392

package/dist/typeshed-fallback/stdlib/unittest/mock.pyi

@@ -1,468 +1,468 @@
-import sys
-from collections.abc import Awaitable, Callable, Coroutine, Iterable, Mapping, Sequence
-from contextlib import _GeneratorContextManager
-from types import TracebackType
-from typing import Any, Final, Generic, Literal, TypeVar, overload
-from typing_extensions import ParamSpec, Self, TypeAlias
-
-_T = TypeVar("_T")
-_TT = TypeVar("_TT", bound=type[Any])
-_R = TypeVar("_R")
-_F = TypeVar("_F", bound=Callable[..., Any])
-_AF = TypeVar("_AF", bound=Callable[..., Coroutine[Any, Any, Any]])
-_P = ParamSpec("_P")
-
-if sys.version_info >= (3, 13):
-    # ThreadingMock added in 3.13
-    __all__ = (
-        "Mock",
-        "MagicMock",
-        "patch",
-        "sentinel",
-        "DEFAULT",
-        "ANY",
-        "call",
-        "create_autospec",
-        "ThreadingMock",
-        "AsyncMock",
-        "FILTER_DIR",
-        "NonCallableMock",
-        "NonCallableMagicMock",
-        "mock_open",
-        "PropertyMock",
-        "seal",
-    )
-else:
-    __all__ = (
-        "Mock",
-        "MagicMock",
-        "patch",
-        "sentinel",
-        "DEFAULT",
-        "ANY",
-        "call",
-        "create_autospec",
-        "AsyncMock",
-        "FILTER_DIR",
-        "NonCallableMock",
-        "NonCallableMagicMock",
-        "mock_open",
-        "PropertyMock",
-        "seal",
-    )
-
-if sys.version_info < (3, 9):
-    __version__: Final[str]
-
-FILTER_DIR: Any
-
-class _SentinelObject:
-    name: Any
-    def __init__(self, name: Any) -> None: ...
-
-class _Sentinel:
-    def __getattr__(self, name: str) -> Any: ...
-
-sentinel: Any
-DEFAULT: Any
-
-_ArgsKwargs: TypeAlias = tuple[tuple[Any, ...], Mapping[str, Any]]
-_NameArgsKwargs: TypeAlias = tuple[str, tuple[Any, ...], Mapping[str, Any]]
-_CallValue: TypeAlias = str | tuple[Any, ...] | Mapping[str, Any] | _ArgsKwargs | _NameArgsKwargs
-
-class _Call(tuple[Any, ...]):
-    def __new__(
-        cls, value: _CallValue = (), name: str | None = "", parent: Any | None = None, two: bool = False, from_kall: bool = True
-    ) -> Self: ...
-    name: Any
-    parent: Any
-    from_kall: Any
-    def __init__(
-        self,
-        value: _CallValue = (),
-        name: str | None = None,
-        parent: Any | None = None,
-        two: bool = False,
-        from_kall: bool = True,
-    ) -> None: ...
-    def __eq__(self, other: object) -> bool: ...
-    def __ne__(self, value: object, /) -> bool:
-        """Return self!=value."""
-        ...
-    def __call__(self, *args: Any, **kwargs: Any) -> _Call: ...
-    def __getattr__(self, attr: str) -> Any: ...
-    def __getattribute__(self, attr: str) -> Any: ...
-    @property
-    def args(self) -> tuple[Any, ...]: ...
-    @property
-    def kwargs(self) -> Mapping[str, Any]: ...
-    def call_list(self) -> Any: ...
-
-call: _Call
-
-class _CallList(list[_Call]):
-    def __contains__(self, value: Any) -> bool: ...
-
-class Base:
-    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
-
-# We subclass with "Any" because mocks are explicitly designed to stand in for other types,
-# something that can't be expressed with our static type system.
-class NonCallableMock(Base, Any):
-    if sys.version_info >= (3, 12):
-        def __new__(
-            cls,
-            spec: list[str] | object | type[object] | None = None,
-            wraps: Any | None = None,
-            name: str | None = None,
-            spec_set: list[str] | object | type[object] | None = None,
-            parent: NonCallableMock | None = None,
-            _spec_state: Any | None = None,
-            _new_name: str = "",
-            _new_parent: NonCallableMock | None = None,
-            _spec_as_instance: bool = False,
-            _eat_self: bool | None = None,
-            unsafe: bool = False,
-            **kwargs: Any,
-        ) -> Self: ...
-    else:
-        def __new__(cls, /, *args: Any, **kw: Any) -> Self: ...
-
-    def __init__(
-        self,
-        spec: list[str] | object | type[object] | None = None,
-        wraps: Any | None = None,
-        name: str | None = None,
-        spec_set: list[str] | object | type[object] | None = None,
-        parent: NonCallableMock | None = None,
-        _spec_state: Any | None = None,
-        _new_name: str = "",
-        _new_parent: NonCallableMock | None = None,
-        _spec_as_instance: bool = False,
-        _eat_self: bool | None = None,
-        unsafe: bool = False,
-        **kwargs: Any,
-    ) -> None: ...
-    def __getattr__(self, name: str) -> Any: ...
-    def __delattr__(self, name: str) -> None: ...
-    def __setattr__(self, name: str, value: Any) -> None: ...
-    def __dir__(self) -> list[str]: ...
-    def assert_called_with(self, *args: Any, **kwargs: Any) -> None: ...
-    def assert_not_called(self) -> None: ...
-    def assert_called_once_with(self, *args: Any, **kwargs: Any) -> None: ...
-    def _format_mock_failure_message(self, args: Any, kwargs: Any, action: str = "call") -> str: ...
-    def assert_called(self) -> None: ...
-    def assert_called_once(self) -> None: ...
-    def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
-    def _extract_mock_name(self) -> str: ...
-    def _get_call_signature_from_name(self, name: str) -> Any: ...
-    def assert_any_call(self, *args: Any, **kwargs: Any) -> None: ...
-    def assert_has_calls(self, calls: Sequence[_Call], any_order: bool = False) -> None: ...
-    def mock_add_spec(self, spec: Any, spec_set: bool = False) -> None: ...
-    def _mock_add_spec(self, spec: Any, spec_set: bool, _spec_as_instance: bool = False, _eat_self: bool = False) -> None: ...
-    def attach_mock(self, mock: NonCallableMock, attribute: str) -> None: ...
-    def configure_mock(self, **kwargs: Any) -> None: ...
-    return_value: Any
-    side_effect: Any
-    called: bool
-    call_count: int
-    call_args: Any
-    call_args_list: _CallList
-    mock_calls: _CallList
-    def _format_mock_call_signature(self, args: Any, kwargs: Any) -> str: ...
-    def _call_matcher(self, _call: tuple[_Call, ...]) -> _Call: ...
-    def _get_child_mock(self, **kw: Any) -> NonCallableMock: ...
-    if sys.version_info >= (3, 13):
-        def _calls_repr(self) -> str: ...
-    else:
-        def _calls_repr(self, prefix: str = "Calls") -> str: ...
-
-class CallableMixin(Base):
-    side_effect: Any
-    def __init__(
-        self,
-        spec: Any | None = None,
-        side_effect: Any | None = None,
-        return_value: Any = ...,
-        wraps: Any | None = None,
-        name: Any | None = None,
-        spec_set: Any | None = None,
-        parent: Any | None = None,
-        _spec_state: Any | None = None,
-        _new_name: Any = "",
-        _new_parent: Any | None = None,
-        **kwargs: Any,
-    ) -> None: ...
-    def __call__(self, *args: Any, **kwargs: Any) -> Any: ...
-
-class Mock(CallableMixin, NonCallableMock): ...
-
-class _patch(Generic[_T]):
-    attribute_name: Any
-    getter: Callable[[], Any]
-    attribute: str
-    new: _T
-    new_callable: Any
-    spec: Any
-    create: bool
-    has_local: Any
-    spec_set: Any
-    autospec: Any
-    kwargs: Mapping[str, Any]
-    additional_patchers: Any
-    # If new==DEFAULT, self is _patch[Any]. Ideally we'd be able to add an overload for it so that self is _patch[MagicMock],
-    # but that's impossible with the current type system.
-    if sys.version_info >= (3, 10):
-        def __init__(
-            self: _patch[_T],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
-            getter: Callable[[], Any],
-            attribute: str,
-            new: _T,
-            spec: Any | None,
-            create: bool,
-            spec_set: Any | None,
-            autospec: Any | None,
-            new_callable: Any | None,
-            kwargs: Mapping[str, Any],
-            *,
-            unsafe: bool = False,
-        ) -> None: ...
-    else:
-        def __init__(
-            self: _patch[_T],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
-            getter: Callable[[], Any],
-            attribute: str,
-            new: _T,
-            spec: Any | None,
-            create: bool,
-            spec_set: Any | None,
-            autospec: Any | None,
-            new_callable: Any | None,
-            kwargs: Mapping[str, Any],
-        ) -> None: ...
-
-    def copy(self) -> _patch[_T]: ...
-    @overload
-    def __call__(self, func: _TT) -> _TT: ...
-    # If new==DEFAULT, this should add a MagicMock parameter to the function
-    # arguments. See the _patch_default_new class below for this functionality.
-    @overload
-    def __call__(self, func: Callable[_P, _R]) -> Callable[_P, _R]: ...
-    def decoration_helper(
-        self, patched: _patch[Any], args: Sequence[Any], keywargs: Any
-    ) -> _GeneratorContextManager[tuple[Sequence[Any], Any]]: ...
-    def decorate_class(self, klass: _TT) -> _TT: ...
-    def decorate_callable(self, func: Callable[..., _R]) -> Callable[..., _R]: ...
-    def decorate_async_callable(self, func: Callable[..., Awaitable[_R]]) -> Callable[..., Awaitable[_R]]: ...
-    def get_original(self) -> tuple[Any, bool]: ...
-    target: Any
-    temp_original: Any
-    is_local: bool
-    def __enter__(self) -> _T: ...
-    def __exit__(
-        self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, /
-    ) -> None: ...
-    def start(self) -> _T: ...
-    def stop(self) -> None: ...
-
-# This class does not exist at runtime, it's a hack to make this work:
-#     @patch("foo")
-#     def bar(..., mock: MagicMock) -> None: ...
-class _patch_default_new(_patch[MagicMock | AsyncMock]):
-    @overload
-    def __call__(self, func: _TT) -> _TT: ...
-    # Can't use the following as ParamSpec is only allowed as last parameter:
-    #   def __call__(self, func: Callable[_P, _R]) -> Callable[Concatenate[_P, MagicMock], _R]: ...
-    @overload
-    def __call__(self, func: Callable[..., _R]) -> Callable[..., _R]: ...
-
-class _patch_dict:
-    in_dict: Any
-    values: Any
-    clear: Any
-    def __init__(self, in_dict: Any, values: Any = (), clear: Any = False, **kwargs: Any) -> None: ...
-    def __call__(self, f: Any) -> Any: ...
-    if sys.version_info >= (3, 10):
-        def decorate_callable(self, f: _F) -> _F: ...
-        def decorate_async_callable(self, f: _AF) -> _AF: ...
-
-    def decorate_class(self, klass: Any) -> Any: ...
-    def __enter__(self) -> Any: ...
-    def __exit__(self, *args: object) -> Any: ...
-    start: Any
-    stop: Any
-
-# This class does not exist at runtime, it's a hack to add methods to the
-# patch() function.
-class _patcher:
-    TEST_PREFIX: str
-    dict: type[_patch_dict]
-    # This overload also covers the case, where new==DEFAULT. In this case, the return type is _patch[Any].
-    # Ideally we'd be able to add an overload for it so that the return type is _patch[MagicMock],
-    # but that's impossible with the current type system.
-    @overload
-    def __call__(
-        self,
-        target: str,
-        new: _T,
-        spec: Any | None = ...,
-        create: bool = ...,
-        spec_set: Any | None = ...,
-        autospec: Any | None = ...,
-        new_callable: Any | None = ...,
-        **kwargs: Any,
-    ) -> _patch[_T]: ...
-    @overload
-    def __call__(
-        self,
-        target: str,
-        *,
-        spec: Any | None = ...,
-        create: bool = ...,
-        spec_set: Any | None = ...,
-        autospec: Any | None = ...,
-        new_callable: Any | None = ...,
-        **kwargs: Any,
-    ) -> _patch_default_new: ...
-    @overload
-    @staticmethod
-    def object(
-        target: Any,
-        attribute: str,
-        new: _T,
-        spec: Any | None = ...,
-        create: bool = ...,
-        spec_set: Any | None = ...,
-        autospec: Any | None = ...,
-        new_callable: Any | None = ...,
-        **kwargs: Any,
-    ) -> _patch[_T]: ...
-    @overload
-    @staticmethod
-    def object(
-        target: Any,
-        attribute: str,
-        *,
-        spec: Any | None = ...,
-        create: bool = ...,
-        spec_set: Any | None = ...,
-        autospec: Any | None = ...,
-        new_callable: Any | None = ...,
-        **kwargs: Any,
-    ) -> _patch[MagicMock | AsyncMock]: ...
-    @staticmethod
-    def multiple(
-        target: Any,
-        spec: Any | None = ...,
-        create: bool = ...,
-        spec_set: Any | None = ...,
-        autospec: Any | None = ...,
-        new_callable: Any | None = ...,
-        **kwargs: Any,
-    ) -> _patch[Any]: ...
-    @staticmethod
-    def stopall() -> None: ...
-
-patch: _patcher
-
-class MagicMixin(Base):
-    def __init__(self, *args: Any, **kw: Any) -> None: ...
-
-class NonCallableMagicMock(MagicMixin, NonCallableMock): ...
-class MagicMock(MagicMixin, Mock): ...
-
-class AsyncMockMixin(Base):
-    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
-    async def _execute_mock_call(self, *args: Any, **kwargs: Any) -> Any: ...
-    def assert_awaited(self) -> None: ...
-    def assert_awaited_once(self) -> None: ...
-    def assert_awaited_with(self, *args: Any, **kwargs: Any) -> None: ...
-    def assert_awaited_once_with(self, *args: Any, **kwargs: Any) -> None: ...
-    def assert_any_await(self, *args: Any, **kwargs: Any) -> None: ...
-    def assert_has_awaits(self, calls: Iterable[_Call], any_order: bool = False) -> None: ...
-    def assert_not_awaited(self) -> None: ...
-    def reset_mock(self, *args: Any, **kwargs: Any) -> None: ...
-    await_count: int
-    await_args: _Call | None
-    await_args_list: _CallList
-
-class AsyncMagicMixin(MagicMixin):
-    def __init__(self, *args: Any, **kw: Any) -> None: ...
-
-class AsyncMock(AsyncMockMixin, AsyncMagicMixin, Mock):
-    # Improving the `reset_mock` signature.
-    # It is defined on `AsyncMockMixin` with `*args, **kwargs`, which is not ideal.
-    # But, `NonCallableMock` super-class has the better version.
-    def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
-
-class MagicProxy(Base):
-    name: str
-    parent: Any
-    def __init__(self, name: str, parent: Any) -> None: ...
-    def create_mock(self) -> Any: ...
-    def __get__(self, obj: Any, _type: Any | None = None) -> Any: ...
-
-class _ANY:
-    def __eq__(self, other: object) -> Literal[True]: ...
-    def __ne__(self, other: object) -> Literal[False]: ...
-
-ANY: Any
-
-if sys.version_info >= (3, 10):
-    def create_autospec(
-        spec: Any,
-        spec_set: Any = False,
-        instance: Any = False,
-        _parent: Any | None = None,
-        _name: Any | None = None,
-        *,
-        unsafe: bool = False,
-        **kwargs: Any,
-    ) -> Any: ...
-
-else:
-    def create_autospec(
-        spec: Any,
-        spec_set: Any = False,
-        instance: Any = False,
-        _parent: Any | None = None,
-        _name: Any | None = None,
-        **kwargs: Any,
-    ) -> Any: ...
-
-class _SpecState:
-    spec: Any
-    ids: Any
-    spec_set: Any
-    parent: Any
-    instance: Any
-    name: Any
-    def __init__(
-        self,
-        spec: Any,
-        spec_set: Any = False,
-        parent: Any | None = None,
-        name: Any | None = None,
-        ids: Any | None = None,
-        instance: Any = False,
-    ) -> None: ...
-
-def mock_open(mock: Any | None = None, read_data: Any = "") -> Any: ...
-
-class PropertyMock(Mock):
-    def __get__(self, obj: _T, obj_type: type[_T] | None = None) -> Self: ...
-    def __set__(self, obj: Any, val: Any) -> None: ...
-
-if sys.version_info >= (3, 13):
-    class ThreadingMixin(Base):
-        DEFAULT_TIMEOUT: Final[float | None] = None
-
-        def __init__(self, /, *args: Any, timeout: float | None | _SentinelObject = ..., **kwargs: Any) -> None: ...
-        # Same as `NonCallableMock.reset_mock.`
-        def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
-        def wait_until_called(self, *, timeout: float | None | _SentinelObject = ...) -> None: ...
-        def wait_until_any_call_with(self, *args: Any, **kwargs: Any) -> None: ...
-
-    class ThreadingMock(ThreadingMixin, MagicMixin, Mock): ...
-
-def seal(mock: Any) -> None: ...
+import sys
+from collections.abc import Awaitable, Callable, Coroutine, Iterable, Mapping, Sequence
+from contextlib import _GeneratorContextManager
+from types import TracebackType
+from typing import Any, Final, Generic, Literal, TypeVar, overload
+from typing_extensions import ParamSpec, Self, TypeAlias
+
+_T = TypeVar("_T")
+_TT = TypeVar("_TT", bound=type[Any])
+_R = TypeVar("_R")
+_F = TypeVar("_F", bound=Callable[..., Any])
+_AF = TypeVar("_AF", bound=Callable[..., Coroutine[Any, Any, Any]])
+_P = ParamSpec("_P")
+
+if sys.version_info >= (3, 13):
+    # ThreadingMock added in 3.13
+    __all__ = (
+        "Mock",
+        "MagicMock",
+        "patch",
+        "sentinel",
+        "DEFAULT",
+        "ANY",
+        "call",
+        "create_autospec",
+        "ThreadingMock",
+        "AsyncMock",
+        "FILTER_DIR",
+        "NonCallableMock",
+        "NonCallableMagicMock",
+        "mock_open",
+        "PropertyMock",
+        "seal",
+    )
+else:
+    __all__ = (
+        "Mock",
+        "MagicMock",
+        "patch",
+        "sentinel",
+        "DEFAULT",
+        "ANY",
+        "call",
+        "create_autospec",
+        "AsyncMock",
+        "FILTER_DIR",
+        "NonCallableMock",
+        "NonCallableMagicMock",
+        "mock_open",
+        "PropertyMock",
+        "seal",
+    )
+
+if sys.version_info < (3, 9):
+    __version__: Final[str]
+
+FILTER_DIR: Any
+
+class _SentinelObject:
+    name: Any
+    def __init__(self, name: Any) -> None: ...
+
+class _Sentinel:
+    def __getattr__(self, name: str) -> Any: ...
+
+sentinel: Any
+DEFAULT: Any
+
+_ArgsKwargs: TypeAlias = tuple[tuple[Any, ...], Mapping[str, Any]]
+_NameArgsKwargs: TypeAlias = tuple[str, tuple[Any, ...], Mapping[str, Any]]
+_CallValue: TypeAlias = str | tuple[Any, ...] | Mapping[str, Any] | _ArgsKwargs | _NameArgsKwargs
+
+class _Call(tuple[Any, ...]):
+    def __new__(
+        cls, value: _CallValue = (), name: str | None = "", parent: Any | None = None, two: bool = False, from_kall: bool = True
+    ) -> Self: ...
+    name: Any
+    parent: Any
+    from_kall: Any
+    def __init__(
+        self,
+        value: _CallValue = (),
+        name: str | None = None,
+        parent: Any | None = None,
+        two: bool = False,
+        from_kall: bool = True,
+    ) -> None: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, value: object, /) -> bool:
+        """Return self!=value."""
+        ...
+    def __call__(self, *args: Any, **kwargs: Any) -> _Call: ...
+    def __getattr__(self, attr: str) -> Any: ...
+    def __getattribute__(self, attr: str) -> Any: ...
+    @property
+    def args(self) -> tuple[Any, ...]: ...
+    @property
+    def kwargs(self) -> Mapping[str, Any]: ...
+    def call_list(self) -> Any: ...
+
+call: _Call
+
+class _CallList(list[_Call]):
+    def __contains__(self, value: Any) -> bool: ...
+
+class Base:
+    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
+
+# We subclass with "Any" because mocks are explicitly designed to stand in for other types,
+# something that can't be expressed with our static type system.
+class NonCallableMock(Base, Any):
+    if sys.version_info >= (3, 12):
+        def __new__(
+            cls,
+            spec: list[str] | object | type[object] | None = None,
+            wraps: Any | None = None,
+            name: str | None = None,
+            spec_set: list[str] | object | type[object] | None = None,
+            parent: NonCallableMock | None = None,
+            _spec_state: Any | None = None,
+            _new_name: str = "",
+            _new_parent: NonCallableMock | None = None,
+            _spec_as_instance: bool = False,
+            _eat_self: bool | None = None,
+            unsafe: bool = False,
+            **kwargs: Any,
+        ) -> Self: ...
+    else:
+        def __new__(cls, /, *args: Any, **kw: Any) -> Self: ...
+
+    def __init__(
+        self,
+        spec: list[str] | object | type[object] | None = None,
+        wraps: Any | None = None,
+        name: str | None = None,
+        spec_set: list[str] | object | type[object] | None = None,
+        parent: NonCallableMock | None = None,
+        _spec_state: Any | None = None,
+        _new_name: str = "",
+        _new_parent: NonCallableMock | None = None,
+        _spec_as_instance: bool = False,
+        _eat_self: bool | None = None,
+        unsafe: bool = False,
+        **kwargs: Any,
+    ) -> None: ...
+    def __getattr__(self, name: str) -> Any: ...
+    def __delattr__(self, name: str) -> None: ...
+    def __setattr__(self, name: str, value: Any) -> None: ...
+    def __dir__(self) -> list[str]: ...
+    def assert_called_with(self, *args: Any, **kwargs: Any) -> None: ...
+    def assert_not_called(self) -> None: ...
+    def assert_called_once_with(self, *args: Any, **kwargs: Any) -> None: ...
+    def _format_mock_failure_message(self, args: Any, kwargs: Any, action: str = "call") -> str: ...
+    def assert_called(self) -> None: ...
+    def assert_called_once(self) -> None: ...
+    def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
+    def _extract_mock_name(self) -> str: ...
+    def _get_call_signature_from_name(self, name: str) -> Any: ...
+    def assert_any_call(self, *args: Any, **kwargs: Any) -> None: ...
+    def assert_has_calls(self, calls: Sequence[_Call], any_order: bool = False) -> None: ...
+    def mock_add_spec(self, spec: Any, spec_set: bool = False) -> None: ...
+    def _mock_add_spec(self, spec: Any, spec_set: bool, _spec_as_instance: bool = False, _eat_self: bool = False) -> None: ...
+    def attach_mock(self, mock: NonCallableMock, attribute: str) -> None: ...
+    def configure_mock(self, **kwargs: Any) -> None: ...
+    return_value: Any
+    side_effect: Any
+    called: bool
+    call_count: int
+    call_args: Any
+    call_args_list: _CallList
+    mock_calls: _CallList
+    def _format_mock_call_signature(self, args: Any, kwargs: Any) -> str: ...
+    def _call_matcher(self, _call: tuple[_Call, ...]) -> _Call: ...
+    def _get_child_mock(self, **kw: Any) -> NonCallableMock: ...
+    if sys.version_info >= (3, 13):
+        def _calls_repr(self) -> str: ...
+    else:
+        def _calls_repr(self, prefix: str = "Calls") -> str: ...
+
+class CallableMixin(Base):
+    side_effect: Any
+    def __init__(
+        self,
+        spec: Any | None = None,
+        side_effect: Any | None = None,
+        return_value: Any = ...,
+        wraps: Any | None = None,
+        name: Any | None = None,
+        spec_set: Any | None = None,
+        parent: Any | None = None,
+        _spec_state: Any | None = None,
+        _new_name: Any = "",
+        _new_parent: Any | None = None,
+        **kwargs: Any,
+    ) -> None: ...
+    def __call__(self, *args: Any, **kwargs: Any) -> Any: ...
+
+class Mock(CallableMixin, NonCallableMock): ...
+
+class _patch(Generic[_T]):
+    attribute_name: Any
+    getter: Callable[[], Any]
+    attribute: str
+    new: _T
+    new_callable: Any
+    spec: Any
+    create: bool
+    has_local: Any
+    spec_set: Any
+    autospec: Any
+    kwargs: Mapping[str, Any]
+    additional_patchers: Any
+    # If new==DEFAULT, self is _patch[Any]. Ideally we'd be able to add an overload for it so that self is _patch[MagicMock],
+    # but that's impossible with the current type system.
+    if sys.version_info >= (3, 10):
+        def __init__(
+            self: _patch[_T],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
+            getter: Callable[[], Any],
+            attribute: str,
+            new: _T,
+            spec: Any | None,
+            create: bool,
+            spec_set: Any | None,
+            autospec: Any | None,
+            new_callable: Any | None,
+            kwargs: Mapping[str, Any],
+            *,
+            unsafe: bool = False,
+        ) -> None: ...
+    else:
+        def __init__(
+            self: _patch[_T],  # pyright: ignore[reportInvalidTypeVarUse]  #11780
+            getter: Callable[[], Any],
+            attribute: str,
+            new: _T,
+            spec: Any | None,
+            create: bool,
+            spec_set: Any | None,
+            autospec: Any | None,
+            new_callable: Any | None,
+            kwargs: Mapping[str, Any],
+        ) -> None: ...
+
+    def copy(self) -> _patch[_T]: ...
+    @overload
+    def __call__(self, func: _TT) -> _TT: ...
+    # If new==DEFAULT, this should add a MagicMock parameter to the function
+    # arguments. See the _patch_default_new class below for this functionality.
+    @overload
+    def __call__(self, func: Callable[_P, _R]) -> Callable[_P, _R]: ...
+    def decoration_helper(
+        self, patched: _patch[Any], args: Sequence[Any], keywargs: Any
+    ) -> _GeneratorContextManager[tuple[Sequence[Any], Any]]: ...
+    def decorate_class(self, klass: _TT) -> _TT: ...
+    def decorate_callable(self, func: Callable[..., _R]) -> Callable[..., _R]: ...
+    def decorate_async_callable(self, func: Callable[..., Awaitable[_R]]) -> Callable[..., Awaitable[_R]]: ...
+    def get_original(self) -> tuple[Any, bool]: ...
+    target: Any
+    temp_original: Any
+    is_local: bool
+    def __enter__(self) -> _T: ...
+    def __exit__(
+        self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None, /
+    ) -> None: ...
+    def start(self) -> _T: ...
+    def stop(self) -> None: ...
+
+# This class does not exist at runtime, it's a hack to make this work:
+#     @patch("foo")
+#     def bar(..., mock: MagicMock) -> None: ...
+class _patch_default_new(_patch[MagicMock | AsyncMock]):
+    @overload
+    def __call__(self, func: _TT) -> _TT: ...
+    # Can't use the following as ParamSpec is only allowed as last parameter:
+    #   def __call__(self, func: Callable[_P, _R]) -> Callable[Concatenate[_P, MagicMock], _R]: ...
+    @overload
+    def __call__(self, func: Callable[..., _R]) -> Callable[..., _R]: ...
+
+class _patch_dict:
+    in_dict: Any
+    values: Any
+    clear: Any
+    def __init__(self, in_dict: Any, values: Any = (), clear: Any = False, **kwargs: Any) -> None: ...
+    def __call__(self, f: Any) -> Any: ...
+    if sys.version_info >= (3, 10):
+        def decorate_callable(self, f: _F) -> _F: ...
+        def decorate_async_callable(self, f: _AF) -> _AF: ...
+
+    def decorate_class(self, klass: Any) -> Any: ...
+    def __enter__(self) -> Any: ...
+    def __exit__(self, *args: object) -> Any: ...
+    start: Any
+    stop: Any
+
+# This class does not exist at runtime, it's a hack to add methods to the
+# patch() function.
+class _patcher:
+    TEST_PREFIX: str
+    dict: type[_patch_dict]
+    # This overload also covers the case, where new==DEFAULT. In this case, the return type is _patch[Any].
+    # Ideally we'd be able to add an overload for it so that the return type is _patch[MagicMock],
+    # but that's impossible with the current type system.
+    @overload
+    def __call__(
+        self,
+        target: str,
+        new: _T,
+        spec: Any | None = ...,
+        create: bool = ...,
+        spec_set: Any | None = ...,
+        autospec: Any | None = ...,
+        new_callable: Any | None = ...,
+        **kwargs: Any,
+    ) -> _patch[_T]: ...
+    @overload
+    def __call__(
+        self,
+        target: str,
+        *,
+        spec: Any | None = ...,
+        create: bool = ...,
+        spec_set: Any | None = ...,
+        autospec: Any | None = ...,
+        new_callable: Any | None = ...,
+        **kwargs: Any,
+    ) -> _patch_default_new: ...
+    @overload
+    @staticmethod
+    def object(
+        target: Any,
+        attribute: str,
+        new: _T,
+        spec: Any | None = ...,
+        create: bool = ...,
+        spec_set: Any | None = ...,
+        autospec: Any | None = ...,
+        new_callable: Any | None = ...,
+        **kwargs: Any,
+    ) -> _patch[_T]: ...
+    @overload
+    @staticmethod
+    def object(
+        target: Any,
+        attribute: str,
+        *,
+        spec: Any | None = ...,
+        create: bool = ...,
+        spec_set: Any | None = ...,
+        autospec: Any | None = ...,
+        new_callable: Any | None = ...,
+        **kwargs: Any,
+    ) -> _patch[MagicMock | AsyncMock]: ...
+    @staticmethod
+    def multiple(
+        target: Any,
+        spec: Any | None = ...,
+        create: bool = ...,
+        spec_set: Any | None = ...,
+        autospec: Any | None = ...,
+        new_callable: Any | None = ...,
+        **kwargs: Any,
+    ) -> _patch[Any]: ...
+    @staticmethod
+    def stopall() -> None: ...
+
+patch: _patcher
+
+class MagicMixin(Base):
+    def __init__(self, *args: Any, **kw: Any) -> None: ...
+
+class NonCallableMagicMock(MagicMixin, NonCallableMock): ...
+class MagicMock(MagicMixin, Mock): ...
+
+class AsyncMockMixin(Base):
+    def __init__(self, *args: Any, **kwargs: Any) -> None: ...
+    async def _execute_mock_call(self, *args: Any, **kwargs: Any) -> Any: ...
+    def assert_awaited(self) -> None: ...
+    def assert_awaited_once(self) -> None: ...
+    def assert_awaited_with(self, *args: Any, **kwargs: Any) -> None: ...
+    def assert_awaited_once_with(self, *args: Any, **kwargs: Any) -> None: ...
+    def assert_any_await(self, *args: Any, **kwargs: Any) -> None: ...
+    def assert_has_awaits(self, calls: Iterable[_Call], any_order: bool = False) -> None: ...
+    def assert_not_awaited(self) -> None: ...
+    def reset_mock(self, *args: Any, **kwargs: Any) -> None: ...
+    await_count: int
+    await_args: _Call | None
+    await_args_list: _CallList
+
+class AsyncMagicMixin(MagicMixin):
+    def __init__(self, *args: Any, **kw: Any) -> None: ...
+
+class AsyncMock(AsyncMockMixin, AsyncMagicMixin, Mock):
+    # Improving the `reset_mock` signature.
+    # It is defined on `AsyncMockMixin` with `*args, **kwargs`, which is not ideal.
+    # But, `NonCallableMock` super-class has the better version.
+    def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
+
+class MagicProxy(Base):
+    name: str
+    parent: Any
+    def __init__(self, name: str, parent: Any) -> None: ...
+    def create_mock(self) -> Any: ...
+    def __get__(self, obj: Any, _type: Any | None = None) -> Any: ...
+
+class _ANY:
+    def __eq__(self, other: object) -> Literal[True]: ...
+    def __ne__(self, other: object) -> Literal[False]: ...
+
+ANY: Any
+
+if sys.version_info >= (3, 10):
+    def create_autospec(
+        spec: Any,
+        spec_set: Any = False,
+        instance: Any = False,
+        _parent: Any | None = None,
+        _name: Any | None = None,
+        *,
+        unsafe: bool = False,
+        **kwargs: Any,
+    ) -> Any: ...
+
+else:
+    def create_autospec(
+        spec: Any,
+        spec_set: Any = False,
+        instance: Any = False,
+        _parent: Any | None = None,
+        _name: Any | None = None,
+        **kwargs: Any,
+    ) -> Any: ...
+
+class _SpecState:
+    spec: Any
+    ids: Any
+    spec_set: Any
+    parent: Any
+    instance: Any
+    name: Any
+    def __init__(
+        self,
+        spec: Any,
+        spec_set: Any = False,
+        parent: Any | None = None,
+        name: Any | None = None,
+        ids: Any | None = None,
+        instance: Any = False,
+    ) -> None: ...
+
+def mock_open(mock: Any | None = None, read_data: Any = "") -> Any: ...
+
+class PropertyMock(Mock):
+    def __get__(self, obj: _T, obj_type: type[_T] | None = None) -> Self: ...
+    def __set__(self, obj: Any, val: Any) -> None: ...
+
+if sys.version_info >= (3, 13):
+    class ThreadingMixin(Base):
+        DEFAULT_TIMEOUT: Final[float | None] = None
+
+        def __init__(self, /, *args: Any, timeout: float | None | _SentinelObject = ..., **kwargs: Any) -> None: ...
+        # Same as `NonCallableMock.reset_mock.`
+        def reset_mock(self, visited: Any = None, *, return_value: bool = False, side_effect: bool = False) -> None: ...
+        def wait_until_called(self, *, timeout: float | None | _SentinelObject = ...) -> None: ...
+        def wait_until_any_call_with(self, *args: Any, **kwargs: Any) -> None: ...
+
+    class ThreadingMock(ThreadingMixin, MagicMixin, Mock): ...
+
+def seal(mock: Any) -> None: ...