Update Unused parameters in stubs/ (#9704)

* Update _Unused TypeAlias

* Update `object | None` params

* Replace unused `object` parameters with `Unused` alias

Author: Avasam

stubs/D3DShot/d3dshot/capture_outputs/pil_capture_output.pyi

@@ -1,12 +1,11 @@
+from _typeshed import Unused
 from collections.abc import Sequence
 from ctypes import _CVoidConstPLike
 from typing import TypeVar
-from typing_extensions import TypeAlias
 
 from d3dshot.capture_output import CaptureOutput
 from PIL import Image
 
-_Unused: TypeAlias = object
 _ImageT = TypeVar("_ImageT", bound=Image.Image)
 
 class PILCaptureOutput(CaptureOutput):
@@ -22,4 +21,4 @@ class PILCaptureOutput(CaptureOutput):
         rotation: int,
     ) -> Image.Image: ...
     def to_pil(self, frame: _ImageT) -> _ImageT: ...
-    def stack(self, frames: Sequence[_ImageT], stack_dimension: _Unused) -> Sequence[_ImageT]: ...
+    def stack(self, frames: Sequence[_ImageT], stack_dimension: Unused) -> Sequence[_ImageT]: ...

stubs/Pillow/PIL/PSDraw.pyi

@@ -1,12 +1,12 @@
-from _typeshed import SupportsWrite
+from _typeshed import SupportsWrite, Unused
 
 from .Image import Image
 
 class PSDraw:
     fp: SupportsWrite[bytes]
     def __init__(self, fp: SupportsWrite[bytes] | None = ...) -> None: ...
     isofont: dict[bytes, int]
-    def begin_document(self, id: object | None = ...) -> None: ...
+    def begin_document(self, id: Unused = None) -> None: ...
     def end_document(self) -> None: ...
     def setfont(self, font: str, size: int) -> None: ...
     def line(self, xy0: tuple[int, int], xy1: tuple[int, int]) -> None: ...

stubs/PyMySQL/pymysql/converters.pyi

@@ -1,5 +1,6 @@
 import datetime
 import time
+from _typeshed import Unused
 from collections.abc import Callable, Mapping, Sequence
 from decimal import Decimal
 from typing import Any, TypeVar
@@ -25,7 +26,7 @@ def escape_time(obj: datetime.time, mapping: _EscaperMapping = ...) -> str: ...
 def escape_datetime(obj: datetime.datetime, mapping: _EscaperMapping = ...) -> str: ...
 def escape_date(obj: datetime.date, mapping: _EscaperMapping = ...) -> str: ...
 def escape_struct_time(obj: time.struct_time, mapping: _EscaperMapping = ...) -> str: ...
-def Decimal2Literal(o: Decimal, d: object) -> str: ...
+def Decimal2Literal(o: Decimal, d: Unused) -> str: ...
 def convert_datetime(obj: str | bytes) -> datetime.datetime | str: ...
 def convert_timedelta(obj: str | bytes) -> datetime.timedelta | str: ...
 def convert_time(obj: str | bytes) -> datetime.time | str: ...

stubs/PyScreeze/pyscreeze/__init__.pyi

@@ -1,11 +1,10 @@
-from _typeshed import Incomplete, StrOrBytesPath
+from _typeshed import Incomplete, StrOrBytesPath, Unused
 from collections.abc import Callable, Generator
 from typing import NamedTuple, SupportsFloat, TypeVar, overload
 from typing_extensions import Final, ParamSpec, SupportsIndex, TypeAlias
 
 from PIL import Image
 
-_Unused: TypeAlias = object
 _P = ParamSpec("_P")
 _R = TypeVar("_R")
 # TODO: cv2.Mat is not available as a type yet:
@@ -49,7 +48,7 @@ def locate(
     haystackImage: str | Image.Image | _Mat,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: SupportsFloat | SupportsIndex | str = 0.999,
@@ -62,7 +61,7 @@ def locate(
     haystackImage: str | Image.Image,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: None = None,
@@ -75,7 +74,7 @@ def locateOnScreen(
     minSearchTime: float = 0,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: SupportsFloat | SupportsIndex | str = 0.999,
@@ -88,7 +87,7 @@ def locateOnScreen(
     minSearchTime: float = 0,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: None = None,
@@ -125,7 +124,7 @@ def locateCenterOnScreen(
     *,
     minSearchTime: float,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: SupportsFloat | SupportsIndex | str = 0.999,
@@ -138,7 +137,7 @@ def locateCenterOnScreen(
     *,
     minSearchTime: float,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     region: tuple[int, int, int, int] | None = None,
     step: int = 1,
     confidence: None = None,
@@ -151,7 +150,7 @@ def locateOnWindow(
     title: str,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     step: int = 1,
     confidence: SupportsFloat | SupportsIndex | str = 0.999,
 ) -> Box | None: ...
@@ -163,7 +162,7 @@ def locateOnWindow(
     title: str,
     *,
     grayscale: bool | None = None,
-    limit: _Unused = 1,
+    limit: Unused = 1,
     step: int = 1,
     confidence: None = None,
 ) -> Box | None: ...

stubs/SQLAlchemy/sqlalchemy/engine/url.pyi

@@ -1,16 +1,19 @@
-from _typeshed import SupportsItems
+from _typeshed import SupportsItems, Unused
 from collections.abc import Iterable, Mapping, Sequence
 from typing import Any, NamedTuple
 from typing_extensions import Self, TypeAlias
 
 from ..util import immutabledict
 from .interfaces import Dialect
 
+# object that produces a password when called with str()
+_PasswordObject: TypeAlias = object
+
 # stub-only helper class
 class _URLTuple(NamedTuple):
     drivername: str
     username: str | None
-    password: str | object | None  # object that produces a password when called with str()
+    password: str | _PasswordObject | None
     host: str | None
     port: int | None
     database: str | None
@@ -24,7 +27,7 @@ class URL(_URLTuple):
         cls,
         drivername: str,
         username: str | None = ...,
-        password: str | object | None = ...,  # object that produces a password when called with str()
+        password: str | _PasswordObject | None = None,
         host: str | None = ...,
         port: int | None = ...,
         database: str | None = ...,
@@ -34,7 +37,7 @@ class URL(_URLTuple):
         self,
         drivername: str | None = ...,
         username: str | None = ...,
-        password: str | object | None = ...,
+        password: str | _PasswordObject | None = None,
         host: str | None = ...,
         port: int | None = ...,
         database: str | None = ...,
@@ -49,7 +52,7 @@ class URL(_URLTuple):
     def __to_string__(self, hide_password: bool = ...) -> str: ...
     def render_as_string(self, hide_password: bool = ...) -> str: ...
     def __copy__(self) -> Self: ...
-    def __deepcopy__(self, memo: object) -> Self: ...
+    def __deepcopy__(self, memo: Unused) -> Self: ...
     def __hash__(self) -> int: ...
     def __eq__(self, other: object) -> bool: ...
     def __ne__(self, other: object) -> bool: ...

stubs/SQLAlchemy/sqlalchemy/log.pyi

@@ -1,3 +1,4 @@
+from _typeshed import Unused
 from logging import Logger
 from typing import Any, TypeVar, overload
 from typing_extensions import Literal, Self, TypeAlias
@@ -32,7 +33,7 @@ def instance_logger(instance: Identified, echoflag: _EchoFlag = ...) -> None: ..
 class echo_property:
     __doc__: str
     @overload
-    def __get__(self, instance: None, owner: object) -> Self: ...
+    def __get__(self, instance: None, owner: Unused) -> Self: ...
     @overload
-    def __get__(self, instance: Identified, owner: object) -> _EchoFlag: ...
+    def __get__(self, instance: Identified, owner: Unused) -> _EchoFlag: ...
     def __set__(self, instance: Identified, value: _EchoFlag) -> None: ...

stubs/SQLAlchemy/sqlalchemy/orm/decl_api.pyi

@@ -1,4 +1,4 @@
-from _typeshed import Incomplete
+from _typeshed import Incomplete, Unused
 from collections.abc import Callable
 from typing import Any, ClassVar, TypeVar, overload
 from typing_extensions import TypeAlias
@@ -28,7 +28,7 @@ _DeclarativeBaseMeta: TypeAlias = Callable[[str, tuple[type[Any], ...], dict[str
 def has_inherited_table(cls: type[Any]) -> bool: ...
 
 class DeclarativeMeta(type):
-    def __init__(cls, classname: str, bases: tuple[type[Any], ...], dict_: dict[str, Any], **kw: object) -> None: ...
+    def __init__(cls, classname: str, bases: tuple[type[Any], ...], dict_: dict[str, Any], **kw: Unused) -> None: ...
     def __setattr__(cls, key: str, value: Any) -> None: ...
     def __delattr__(cls, key: str) -> None: ...
 

stubs/SQLAlchemy/sqlalchemy/util/_collections.pyi

@@ -1,5 +1,5 @@
 import collections.abc
-from _typeshed import Incomplete, SupportsKeysAndGetItem
+from _typeshed import Incomplete, SupportsKeysAndGetItem, Unused
 from collections.abc import Callable, Iterable, Iterator, Mapping
 from typing import Any, Generic, NoReturn, TypeVar, overload
 from typing_extensions import Self
@@ -16,9 +16,9 @@ collections_abc = collections.abc
 EMPTY_SET: frozenset[Any]
 
 class ImmutableContainer:
-    def __delitem__(self, *arg: object, **kw: object) -> NoReturn: ...
-    def __setitem__(self, *arg: object, **kw: object) -> NoReturn: ...
-    def __setattr__(self, *arg: object, **kw: object) -> NoReturn: ...
+    def __delitem__(self, *arg: Unused, **kw: Unused) -> NoReturn: ...
+    def __setitem__(self, *arg: Unused, **kw: Unused) -> NoReturn: ...
+    def __setattr__(self, *arg: Unused, **kw: Unused) -> NoReturn: ...
 
 @overload
 def coerce_to_immutabledict(d: None) -> immutabledict[Any, Any]: ...

stubs/SQLAlchemy/sqlalchemy/util/langhelpers.pyi

@@ -1,4 +1,4 @@
-from _typeshed import Incomplete
+from _typeshed import Incomplete, Unused
 from collections.abc import Callable
 from typing import Any, Generic, TypeVar, overload
 from typing_extensions import Self
@@ -71,9 +71,9 @@ class memoized_property(Generic[_R]):
     __name__: str
     def __init__(self, fget: Callable[..., _R], doc: str | None = ...) -> None: ...
     @overload
-    def __get__(self, obj: None, cls: object) -> Self: ...
+    def __get__(self, obj: None, cls: Unused) -> Self: ...
     @overload
-    def __get__(self, obj: object, cls: object) -> _R: ...
+    def __get__(self, obj: object, cls: Unused) -> _R: ...
     @classmethod
     def reset(cls, obj: object, name: str) -> None: ...
 
@@ -86,9 +86,9 @@ class HasMemoized:
         __name__: str
         def __init__(self, fget: Callable[..., _R], doc: str | None = ...) -> None: ...
         @overload
-        def __get__(self, obj: None, cls: object) -> Self: ...
+        def __get__(self, obj: None, cls: Unused) -> Self: ...
         @overload
-        def __get__(self, obj: object, cls: object) -> _R: ...
+        def __get__(self, obj: object, cls: Unused) -> _R: ...
 
     @classmethod
     def memoized_instancemethod(cls, fn): ...

stubs/cachetools/cachetools/keys.pyi

@@ -1,7 +1,8 @@
+from _typeshed import Unused
 from collections.abc import Hashable
 
 __all__ = ("hashkey", "methodkey", "typedkey")
 
 def hashkey(*args: Hashable, **kwargs: Hashable) -> tuple[Hashable, ...]: ...
-def methodkey(self: object, *args: Hashable, **kwargs: Hashable) -> tuple[Hashable, ...]: ...
+def methodkey(self: Unused, *args: Hashable, **kwargs: Hashable) -> tuple[Hashable, ...]: ...
 def typedkey(*args: Hashable, **kwargs: Hashable) -> tuple[Hashable, ...]: ...