feat: Conform to PEP 570 for descriptor protocols and dunder methods in hints.pyi.

Apply '/' marker to descriptor protocol and dunder methods,
improving clarity and compliance with PEP 570.

Author: junkmd

comtypes/hints.pyi

@@ -105,31 +105,35 @@ class _GetSetNormalProperty(Generic[_T_Inst, _R_Get, _T_SetVal]):
     fset: Callable[[_T_Inst, _T_SetVal], Any]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
-    def __get__(self, instance: _T_Inst, owner: Optional[type[_T_Inst]]) -> _R_Get: ...
-    def __set__(self, instance: _T_Inst, value: _T_SetVal) -> None: ...
+    def __get__(
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
+    ) -> _R_Get: ...
+    def __set__(self, instance: _T_Inst, value: _T_SetVal, /) -> None: ...
 
 class _GetOnlyNormalProperty(Generic[_T_Inst, _R_Get]):
     fget: Callable[[_T_Inst], Any]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
-    def __get__(self, instance: _T_Inst, owner: Optional[type[_T_Inst]]) -> _R_Get: ...
-    def __set__(self, instance: _T_Inst, value: Any) -> NoReturn: ...
+    def __get__(
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
+    ) -> _R_Get: ...
+    def __set__(self, instance: _T_Inst, value: Any, /) -> NoReturn: ...
 
 class _SetOnlyNormalProperty(Generic[_T_Inst, _T_SetVal]):
     fget: Callable[[_T_Inst], Any]
     fset: Callable[[_T_Inst, _T_SetVal], Any]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
     def __get__(
-        self, instance: _T_Inst, owner: Optional[type[_T_Inst]]
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
     ) -> NoReturn: ...
-    def __set__(self, instance: _T_Inst, value: _T_SetVal) -> None: ...
+    def __set__(self, instance: _T_Inst, value: _T_SetVal, /) -> None: ...
 
 @overload
 def normal_property(
@@ -149,9 +153,9 @@ class _GetSetBoundNamedProperty(Generic[_T_Inst, _P_Get, _R_Get, _P_Set]):
     fget: Callable[Concatenate[_T_Inst, _P_Get], _R_Get]
     fset: Callable[Concatenate[_T_Inst, _P_Set], Any]
     __doc__: Optional[str]
-    def __getitem__(self, index: Any) -> _R_Get: ...
+    def __getitem__(self, index: Any, /) -> _R_Get: ...
     def __call__(self, *args: _P_Get.args, **kwargs: _P_Get.kwargs) -> _R_Get: ...
-    def __setitem__(self, index: Any, value: Any) -> None: ...
+    def __setitem__(self, index: Any, value: Any, /) -> None: ...
     def __iter__(self) -> NoReturn: ...
 
 class _GetSetNamedProperty(Generic[_T_Inst, _P_Get, _R_Get, _P_Set]):
@@ -161,20 +165,20 @@ class _GetSetNamedProperty(Generic[_T_Inst, _P_Get, _R_Get, _P_Set]):
     __doc__: Optional[str]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
     def __get__(
-        self, instance: _T_Inst, owner: Optional[type[_T_Inst]]
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
     ) -> _GetSetBoundNamedProperty[_T_Inst, _P_Get, _R_Get, _P_Set]: ...
-    def __set__(self, instance: _T_Inst, value: Any) -> NoReturn: ...
+    def __set__(self, instance: _T_Inst, value: Any, /) -> NoReturn: ...
 
 class _GetOnlyBoundNamedProperty(Generic[_T_Inst, _P_Get, _R_Get]):
     name: str
     fget: Callable[Concatenate[_T_Inst, _P_Get], _R_Get]
     __doc__: Optional[str]
-    def __getitem__(self, index: Any) -> _R_Get: ...
+    def __getitem__(self, index: Any, /) -> _R_Get: ...
     def __call__(self, *args: _P_Get.args, **kwargs: _P_Get.kwargs) -> _R_Get: ...
-    def __setitem__(self, index: Any, value: Any) -> NoReturn: ...
+    def __setitem__(self, index: Any, value: Any, /) -> NoReturn: ...
     def __iter__(self) -> NoReturn: ...
 
 class _GetOnlyNamedProperty(Generic[_T_Inst, _P_Get, _R_Get]):
@@ -183,20 +187,20 @@ class _GetOnlyNamedProperty(Generic[_T_Inst, _P_Get, _R_Get]):
     __doc__: Optional[str]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
     def __get__(
-        self, instance: _T_Inst, owner: Optional[type[_T_Inst]]
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
     ) -> _GetOnlyBoundNamedProperty[_T_Inst, _P_Get, _R_Get]: ...
-    def __set__(self, instance: _T_Inst, value: Any) -> NoReturn: ...
+    def __set__(self, instance: _T_Inst, value: Any, /) -> NoReturn: ...
 
 class _SetOnlyBoundNamedProperty(Generic[_T_Inst, _P_Set]):
     name: str
     fset: Callable[Concatenate[_T_Inst, _P_Set], Any]
     __doc__: Optional[str]
-    def __getitem__(self, index: Any) -> NoReturn: ...
+    def __getitem__(self, index: Any, /) -> NoReturn: ...
     def __call__(self, *args: Any, **kwargs: Any) -> NoReturn: ...
-    def __setitem__(self, index: Any, value: Any) -> None: ...
+    def __setitem__(self, index: Any, value: Any, /) -> None: ...
     def __iter__(self) -> NoReturn: ...
 
 class _SetOnlyNamedProperty(Generic[_T_Inst, _P_Set]):
@@ -205,12 +209,12 @@ class _SetOnlyNamedProperty(Generic[_T_Inst, _P_Set]):
     __doc__: Optional[str]
 
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
     def __get__(
-        self, instance: _T_Inst, owner: Optional[type[_T_Inst]]
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
     ) -> _SetOnlyBoundNamedProperty[_T_Inst, _P_Set]: ...
-    def __set__(self, instance: _T_Inst, value: Any) -> NoReturn: ...
+    def __set__(self, instance: _T_Inst, value: Any, /) -> NoReturn: ...
 
 @overload
 def named_property(
@@ -231,9 +235,11 @@ def named_property(
 
 class _Descriptor(Protocol[_T_Inst, _R_Get]):
     @overload
-    def __get__(self, instance: None, owner: type[_T_Inst]) -> Self: ...
+    def __get__(self, instance: None, owner: type[_T_Inst], /) -> Self: ...
     @overload
-    def __get__(self, instance: _T_Inst, owner: Optional[type[_T_Inst]]) -> _R_Get: ...
+    def __get__(
+        self, instance: _T_Inst, owner: Optional[type[_T_Inst]], /
+    ) -> _R_Get: ...
 
 # `__len__` for objects with `Count`
 @overload