Use PEP 570 syntax in third party stubs (#11554)

Author: hauntsaninja

stubs/Deprecated/deprecated/classic.pyi

@@ -19,7 +19,7 @@ class ClassicAdapter:
     def __call__(self, wrapped: _F) -> Callable[[_F], _F]: ...
 
 @overload
-def deprecated(__wrapped: _F) -> _F: ...
+def deprecated(wrapped: _F, /) -> _F: ...
 @overload
 def deprecated(
     reason: str = ..., *, version: str = ..., action: _Actions | None = ..., category: type[Warning] | None = ...

stubs/ExifRead/exifread/_types.pyi

@@ -9,6 +9,6 @@ TagDict: TypeAlias = dict[int, tuple[str] | tuple[str, Any]]
 
 class Reader(Protocol):
     def __iter__(self) -> bytes: ...
-    def read(self, __size: int) -> bytes: ...
+    def read(self, size: int, /) -> bytes: ...
     def tell(self) -> int: ...
-    def seek(self, __offset: int, __whence: Literal[0, 1] = ...) -> object: ...
+    def seek(self, offset: int, whence: Literal[0, 1] = ..., /) -> object: ...

stubs/Flask-SocketIO/flask_socketio/__init__.pyi

@@ -54,7 +54,7 @@ class SocketIO:
     def on_error_default(self, exception_handler: _ExceptionHandler[_R_co]) -> _ExceptionHandler[_R_co]: ...
     def on_event(self, message: str, handler: _Handler[[Incomplete], object], namespace: str | None = None) -> None: ...
     @overload
-    def event(self, __event_handler: _Handler[_P, _R_co]) -> _Handler[_P, _R_co]: ...
+    def event(self, event_handler: _Handler[_P, _R_co], /) -> _Handler[_P, _R_co]: ...
     @overload
     def event(self, namespace: str | None = None, *args, **kwargs) -> _HandlerDecorator: ...
     def on_namespace(self, namespace_handler: Namespace) -> None: ...

stubs/Markdown/markdown/core.pyi

@@ -10,13 +10,13 @@ from .util import HtmlStash, Registry
 # TODO: The following protocols can be replaced by their counterparts from
 # codecs, once they have been propagated to all type checkers.
 class _WritableStream(Protocol):
-    def write(self, __data: bytes) -> object: ...
-    def seek(self, __offset: int, __whence: int) -> object: ...
+    def write(self, data: bytes, /) -> object: ...
+    def seek(self, offset: int, whence: int, /) -> object: ...
     def close(self) -> object: ...
 
 class _ReadableStream(Protocol):
-    def read(self, __size: int = ...) -> bytes: ...
-    def seek(self, __offset: int, __whence: int) -> object: ...
+    def read(self, size: int = ..., /) -> bytes: ...
+    def seek(self, offset: int, whence: int, /) -> object: ...
     def close(self) -> object: ...
 
 class Markdown:

stubs/Pillow/PIL/Image.pyi

@@ -34,7 +34,7 @@ _Color: TypeAlias = (
 )
 
 class _Writeable(SupportsWrite[bytes], Protocol):
-    def seek(self, __offset: int) -> Any: ...
+    def seek(self, offset: int, /) -> Any: ...
 
 # Ref: https://numpy.org/doc/stable/reference/arrays.interface.html#python-side
 class _SupportsArrayInterface(Protocol):

stubs/Pillow/PIL/ImageFont.pyi

@@ -12,7 +12,7 @@ class Layout(IntEnum):
 MAX_STRING_LENGTH: Final[int] = 1_000_000
 
 class _Font(Protocol):
-    def getmask(self, __text: str | bytes, __mode: str = ..., direction=..., features=...): ...
+    def getmask(self, text: str | bytes, mode: str = ..., /, direction=..., features=...): ...
 
 class ImageFont:
     def getmask(self, text: str | bytes, mode: str = "", direction=..., features=...): ...

stubs/Pillow/PIL/ImageOps.pyi

@@ -9,7 +9,7 @@ from .ImageColor import _Ink
 _Border: TypeAlias = int | tuple[int, int] | tuple[int, int, int, int]
 
 class _Deformer(Protocol):
-    def getmesh(self, __image: Image): ...
+    def getmesh(self, image: Image, /): ...
 
 def autocontrast(
     image: Image,

stubs/Pillow/PIL/_imaging.pyi

@@ -17,13 +17,13 @@ class _PixelAccessor(Protocol):  # noqa: Y046
     #
     # This protocol describes that interface.
     # TODO: should the color args and getter return types be _Color?
-    def __setitem__(self, __xy: tuple[int, int], __color: Incomplete) -> None: ...
-    def __getitem__(self, __xy: tuple[int, int]) -> Incomplete: ...
-    def putpixel(self, __xy: tuple[int, int], __color: Incomplete) -> None: ...
-    def getpixel(self, __xy: tuple[int, int]) -> Incomplete: ...
+    def __setitem__(self, xy: tuple[int, int], color: Incomplete, /) -> None: ...
+    def __getitem__(self, xy: tuple[int, int], /) -> Incomplete: ...
+    def putpixel(self, xy: tuple[int, int], color: Incomplete, /) -> None: ...
+    def getpixel(self, xy: tuple[int, int], /) -> Incomplete: ...
 
 class _Path:
     def __getattr__(self, item: str) -> Incomplete: ...
 
-def path(__x: Sequence[tuple[float, float]] | Sequence[float]) -> _Path: ...
-def __getattr__(__name: str) -> Incomplete: ...
+def path(x: Sequence[tuple[float, float]] | Sequence[float], /) -> _Path: ...
+def __getattr__(name: str, /) -> Incomplete: ...

stubs/PyYAML/yaml/emitter.pyi

@@ -8,7 +8,7 @@ from .events import Event
 _T_contra = TypeVar("_T_contra", str, bytes, contravariant=True)
 
 class _WriteStream(Protocol[_T_contra]):
-    def write(self, __data: _T_contra) -> object: ...
+    def write(self, data: _T_contra, /) -> object: ...
     # Optional fields:
     # encoding: str
     # def flush(self) -> object: ...

stubs/WTForms/wtforms/fields/core.pyi

@@ -17,7 +17,7 @@ _FieldT_contra = TypeVar("_FieldT_contra", bound=Field, contravariant=True)
 _Filter: TypeAlias = Callable[[Any], Any]
 
 class _Validator(Protocol[_FormT_contra, _FieldT_contra]):
-    def __call__(self, __form: _FormT_contra, __field: _FieldT_contra) -> object: ...
+    def __call__(self, form: _FormT_contra, field: _FieldT_contra, /) -> object: ...
 
 class _Widget(Protocol[_FieldT_contra]):
     def __call__(self, field: _FieldT_contra, **kwargs: Any) -> Markup: ...